функция обратного вызова EVT_UCX_USBDEVICE_GET_CHARACTERISTIC (ucxusbdevice.h)

Статья
02/07/2025

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(состояние) равно TRUE. В противном случае он должен вернуть значение состояния, для которого значение NT_SUCCESS(status) равно FALSE.

Замечания

Драйвер клиента UCX регистрирует свою реализацию с расширением контроллера USB-узла (UCX), вызвав метод UcxUsbDeviceCreate.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1709
минимальный поддерживаемый сервер	Windows Server 2016
целевая платформа	Виндоус
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
заголовка	ucxusbdevice.h (include Ucxclass.h)
IRQL	<=DISPATCH_LEVEL

Поделиться через