次の方法で共有


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