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