EVT_UCM_CONNECTOR_SET_POWER_ROLE コールバック関数 (ucmmanager.h)
パートナー コネクタにアタッチされたときに、コネクタの電源ロールを指定したロールに設定する 、EVT_UCM_CONNECTOR_SET_POWER_ROLE イベント コールバック関数のクライアント ドライバーの実装。
構文
EVT_UCM_CONNECTOR_SET_POWER_ROLE EvtUcmConnectorSetPowerRole;
NTSTATUS EvtUcmConnectorSetPowerRole(
[in] UCMCONNECTOR Connector,
[in] UCM_POWER_ROLE PowerRole
)
{...}
パラメーター
[in] Connector
UcmConnectorCreate メソッドの以前の呼び出しでクライアント ドライバーが受信したコネクタを処理します。
[in] PowerRole
設定 するロールを指定するUCM_POWER_ROLE型指定フラグ。
戻り値
操作が成功した場合、コールバック関数は STATUS_SUCCESS、または NT_SUCCESS(status) が TRUE に等しい別の状態値を返す必要があります。 それ以外の場合は、NT_SUCCESS(status) が FALSE である状態値を返す必要があります。
注釈
EVT_UCM_CONNECTOR_SET_POWER_ROLEコールバック関数を登録するには、クライアントで UcmConnectorCreate を呼び出す必要があります。
USB コネクタ マネージャー フレームワーク拡張機能 (UcmCx) は、 UcmPowerRoleSink または UcmPowerRoleSource を要求できます。 ポートが要求されたロールに既にある場合、クライアント ドライバーは変更なしで要求を完了できます。 それ以外の場合は、電源ロールスワップ操作 (PR_Swap) が開始されます。 ドライバーは UcmConnectorPowerDirectionChanged を呼び出して、その操作の成功または失敗について UcmCx に通知します。 ドライバーは、コールバック関数内でそのメソッドを呼び出すことができます。
ロールは、現在の接続に対して保持されます。
ロールスワップ操作が保留中の場合、UcmCx は別のロールスワップを要求しません。 これらの操作は、電源とデータロールのスワップ間でシリアル化されます。
スワップ操作が完了した後、パートナー ポートがPR_Swap要求を送信する場合、クライアント ドライバーは要求を拒否する必要があります。
例
EVT_UCM_CONNECTOR_SET_POWER_ROLE EvtSetPowerRole;
NTSTATUS
EvtSetPowerRole(
UCMCONNECTOR Connector,
UCM_POWER_ROLE PowerRole
)
{
PCONNECTOR_CONTEXT connCtx;
TRACE_INFO("EvtSetPowerRole(%!UCM_POWER_ROLE!) Entry", PowerRole);
connCtx = GetConnectorContext(Connector);
//PR_Swap operation.
TRACE_FUNC_EXIT();
return STATUS_SUCCESS;
}
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 10 |
| サポートされている最小のサーバー | Windows Server 2016 |
| 対象プラットフォーム | Windows |
| 最小 KMDF バージョン | 1.15 |
| 最小 UMDF バージョン | 2.15 |
| Header | ucmmanager.h (Ucmcx.h を含む) |
| IRQL | PASSIVE_LEVEL |