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

UCX 物件的句柄，代表用戶端驅動程式在先前呼叫 UcxUsbDeviceCreate 方法中所收到的 USB 裝置。

[in, out] UcxUsbDeviceCharacteristic

UCX_USBDEVICE_CHARACTERISTIC 結構的指標，其中包含呼叫端感興趣的特性類型。 用戶端驅動程式會填滿要求之特性的值。 例如，如果類型指出UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY，驅動程式會填入PathDelay成員指向的UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY結構，並具有適當的最大值並傳送路徑延遲值。

傳回值

如果作業成功，回呼函式必須傳回STATUS_SUCCESS，或NT_SUCCESS (状态) 等於 TRUE 的另一個狀態值。 否則，它必須傳回狀態值，NT_SUCCESS (状态) 等於 FALSE。

備註

UCX 用戶端驅動程式會藉由呼叫 UcxUsbDeviceCreate 方法，向 USB 主控制器擴充功能 (UCX) 註冊其實作。

規格需求

需求	值
最低支援的用戶端	Windows 10 (版本 1709)
最低支援的伺服器	Windows Server 2016
目標平台	Windows
最低 KMDF 版本	1.0
最低UMDF版本	2.0
標頭	ucxusbdevice.h (包含 Ucxclass.h)
IRQL	<=DISPATCH_LEVEL