EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS コールバック関数 (ucxcontroller.h)
UCX は、このコールバックを呼び出して、ホスト コントローラーの特性を取得します。
構文
EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS EvtUcxControllerGetTransportCharacteristics;
NTSTATUS EvtUcxControllerGetTransportCharacteristics(
[in] UCXCONTROLLER UcxController,
[out] PUCX_CONTROLLER_TRANSPORT_CHARACTERISTICS UcxControllerTransportCharacteristics
)
{...}
パラメーター
[in] UcxController
UcxControllerCreate メソッドの以前の呼び出しでクライアント ドライバーが受信した UCX コントローラーへのハンドル。
[out] UcxControllerTransportCharacteristics
ホスト コントローラーのクライアント ドライバーがトランスポート特性を満たす UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS 構造体へのポインター。
戻り値
操作が成功した場合、コールバック関数は STATUS_SUCCESS、または NT_SUCCESS(status) が TRUE に等しい別の状態値を返す必要があります。 それ以外の場合は、NT_SUCCESS(status) が FALSE である状態値を返す必要があります。
注釈
UCX クライアント ドライバーは、 UcxControllerCreate メソッドを呼び出すことによって、その実装を USB ホスト コントローラー拡張機能 (UCX) に登録します。
このコールバック関数は省略可能です。 トランスポート特性が変更されるたびに、クライアント ドライバーは UCX に、新しい関数 UcxControllerNotifyTransportCharacteristicsChange を使用して特性の 1 つが変更されたことを通知します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 10 バージョン 1709 |
サポートされている最小のサーバー | Windows Server 2016 |
対象プラットフォーム | Windows |
最小 KMDF バージョン | 1.0 |
最小 UMDF バージョン | 2.0 |
Header | ucxcontroller.h (Ucxclass.h を含む) |
IRQL | PASSIVE_LEVEL |