функция обратного вызова 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

Дескриптор контроллера UCX, который драйвер клиента получил при предыдущем вызове метода UcxControllerCreate .

[in] UcxUsbDevice

Дескриптор объекта UCX, представляющего USB-устройство, полученное драйвером клиента при предыдущем вызове метода UcxUsbDeviceCreate .

[in, out] UcxUsbDeviceCharacteristic

Указатель на структуру UCX_USBDEVICE_CHARACTERISTIC , содержащую тип характеристики, в которой заинтересован вызывающий объект. Драйвер клиента заполняет значение запрошенной характеристики. Например, если тип указывает UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY, драйвер заполняет структуру UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY , на которую указывает элемент PathDelay , соответствующими максимальными значениями и значениями задержки пути отправки.

Возвращаемое значение

Если операция выполнена успешно, функция обратного вызова должна возвращать STATUS_SUCCESS или другое значение состояния, для которого NT_SUCCESS(status) равно TRUE. В противном случае он должен возвращать значение состояния, для которого NT_SUCCESS (status) равно FALSE.

Комментарии

Драйвер клиента UCX регистрирует свою реализацию в расширении КОНТРОЛЛЕРа узла USB (UCX), вызывая метод UcxUsbDeviceCreate .

Требования

Требование Значение
Минимальная версия клиента Windows 10 версии 1709
Минимальная версия сервера Windows Server 2016
Целевая платформа Windows
Минимальная версия KMDF 1,0
Минимальная версия UMDF 2,0
Верхняя часть ucxusbdevice.h (включая Ucxclass.h)
IRQL <=DISPATCH_LEVEL