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 |