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

こちらもご覧ください

• UcmConnectorCreate