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

こちらもご覧ください

UcxControllerCreate