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) に登録します。

このコールバック関数は省略可能です。 トランスポート特性が変更されるたびに、クライアント ドライバーは、UcxControllerNotifyTransportCharacteristicsChange 新しい関数を使用して、特性の 1 つが変更されたことを UCX に通知する役割を担います。

必要条件

要件	価値
サポートされる最小クライアント	Windows 10 バージョン 1709
サポートされる最小サーバー	Windows Server 2016
ターゲット プラットフォーム の	ウィンドウズ
最小 KMDF バージョン	1.0
UMDF の最小バージョン を する	2.0
ヘッダー	ucxcontroller.h (Ucxclass.h を含む)
IRQL	PASSIVE_LEVEL

関連項目

UcxControllerCreate の