UcmConnectorPowerDirectionChanged 関数 (ucmmanager.h)
USB コネクタ マネージャー フレームワーク拡張機能 (UcmCx) に、パートナー コネクタの新しい電源ロールを通知します。
構文
void UcmConnectorPowerDirectionChanged(
[in] UCMCONNECTOR Connector,
[in] BOOLEAN Success,
[in] UCM_POWER_ROLE CurrentPowerRole
);
パラメーター
[in] Connector
UcmConnectorCreate の前回の呼び出しでクライアント ドライバーが受信したコネクタ オブジェクトを処理します。
[in] Success
EVT_UCM_CONNECTOR_SET_POWER_ROLEを使用して UcmCx によって開始された電源ロール スワップの失敗を示すために使用されます。
TRUE の場合、操作は成功しました。 FALSE。それ以外の場合は 。
[in] CurrentPowerRole
新しいデータ ロールを示す UCM_POWER_ROLE型指定のフラグの 1 つ。
戻り値
なし
解説
操作が成功した場合、UcmConnectorPowerDirectionChanged は STATUS_SUCCESSを返します。 それ以外の場合、このインライン関数は適切な NTSTATUS 値を 返すことができます。
コネクタ パートナーが接続されている場合、UcmCx は CurrentPowerRole 値に応じてパートナーの電源ロールを更新します。
UcmCx はコネクタの電源ロールを変更し、 EVT_UCM_CONNECTOR_SET_POWER_ROLEを呼び出すことができます。 その呼び出しに応答して、クライアントはPR_Swap操作を実行し、 UcmConnectorPowerDirectionChanged を呼び出して操作の成功/失敗を示す必要があります。
または、クライアント ドライバーがロールスワップを自律的に実行することを選択するか、パートナーがロールスワップを実行する可能性があります。 どちらの場合も、ロールスワップが完了すると、ドライバーは UcmConnectorPowerDirectionChanged を使用して UcmCx に新しいロールを報告する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 10 |
| サポートされている最小のサーバー | Windows Server 2016 |
| 対象プラットフォーム | Windows |
| 最小 KMDF バージョン | 1.15 |
| 最小 UMDF バージョン | 2.15 |
| Header | ucmmanager.h (Ucmcx.h を含む) |
| Library | UcmCxstub.lib |
| IRQL | PASSIVE_LEVEL |