次の方法で共有


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