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
対象プラットフォーム	Windows
最小 KMDF バージョン	1.0
最小 UMDF バージョン	2.0
Header	ucxusbdevice.h (Ucxclass.h を含む)
IRQL	<=DISPATCH_LEVEL