EVT_UCX_USBDEVICE_GET_CHARACTERISTIC コールバック関数 (ucxusbdevice.h)

UCX はこのコールバックを呼び出して、デバイスの特性を取得します。

構文

EVT_UCX_USBDEVICE_GET_CHARACTERISTIC EvtUcxUsbdeviceGetCharacteristic;

NTSTATUS EvtUcxUsbdeviceGetCharacteristic(
  [in]      UCXCONTROLLER UcxController,
  [in]      UCXUSBDEVICE UcxUsbDevice,
  [in, out] PUCX_USBDEVICE_CHARACTERISTIC UcxUsbDeviceCharacteristic
)
{...}

パラメーター

[in] UcxController

UcxControllerCreate メソッドの以前の呼び出しでクライアント ドライバーが受信した UCX コントローラーへのハンドル。

[in] UcxUsbDevice

UcxUsbDeviceCreate メソッドの以前の呼び出しでクライアント ドライバーが受信した USB デバイスを表す UCX オブジェクトへのハンドル。

[in, out] UcxUsbDeviceCharacteristic

呼び出し元が関心を持つ特性の型を含む UCX_USBDEVICE_CHARACTERISTIC 構造体へのポインター。 クライアント ドライバーは、要求された特性の値を入力します。 たとえば、型が UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAYを示す場合、ドライバーは、pathDelay メンバー 指す UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY 構造体に、適切な最大値と送信パスの遅延値を入力します。

戻り値

操作が成功した場合、コールバック関数はSTATUS_SUCCESSを返すか、NT_SUCCESS(status) が TRUE の別の状態値を返す必要があります。 それ以外の場合は、NT_SUCCESS(status) が FALSE の状態値を返す必要があります。

備考

UCX クライアント ドライバーは、UcxUsbDeviceCreate メソッドを呼び出すことによって、その実装を USB ホスト コントローラー拡張機能 (UCX) に登録します。

必要条件

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