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

Замечания

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

Требования