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