Функция UdecxWdfDeviceTryHandleUserIoctl (udecxwdfdevice.h)

Статья
02/07/2025

Пытается обработать запрос IOCTL, отправленный программным обеспечением в пользовательском режиме.

Синтаксис

BOOLEAN UdecxWdfDeviceTryHandleUserIoctl(
       WDFDEVICE  UdecxWdfDevice,
  [in] WDFREQUEST Request
);

Параметры

UdecxWdfDevice

Дескриптор объекта устройства платформы, представляющего контроллер. Драйвер клиента инициализировал этот объект в предыдущем вызове UdecxWdfDeviceAddUsbDeviceEmulation.

[in] Request

Дескриптор объекта запроса платформы, представляющий запрос IOCTL.

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

TRUE указывает, что расширение класса эмуляции USB-устройства (UdeCx) распознало и завершило запрос (с успехом или сбоем). В этом случае драйвер клиента не должен завершить запрос. ЗНАЧЕНИЕ FALSE; в противном случае; Драйвер должен завершить запрос.

Замечания

Клиентский драйвер UDE представляет собой программное обеспечение в пользовательском режиме в качестве драйвера контроллера узла. Драйвер клиента регистрирует и предоставляет guid интерфейса устройства GUID_DEVINTERFACE_USB_HOST_CONTROLLER. Программное обеспечение в пользовательском режиме может открыть дескриптор устройства, указав этот GUID. С помощью этого дескриптора программное обеспечение может отправлять запросы IOCTL.

Примечание Обратите внимание, что коды IOCTL другого интерфейса могут перекрываться с интерфейсом контроллера USB-узла. Если такая функция ввода-вывода достигает этой функции, IOCTL не будет обрабатываться правильно.

Драйвер клиента не нуждается в обработке полученного IOCTL. Он может отправить запрос в расширение класса, вызвав UdecxWdfDeviceTryHandleUserIoctl. Если расширение класса распознает запрос как стандартный запрос, он завершает его. В противном случае вызов завершается сбоем, и драйвер клиента должен завершить запрос. Список операций ввода-вывода вещей, которые должны обрабатываться, см. в USB-ioCTLs для приложений и служб.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10
минимальный поддерживаемый сервер	Windows Server 2016
целевая платформа	Виндоус
минимальная версия KMDF	1.15
заголовка	udecxwdfdevice.h (include Udecx.h)
библиотеки	Udecxstub.lib
IRQL	PASSIVE_LEVEL

См. также

архитектура : эмуляция USB-устройств (UDE)

запись драйвера клиента UDE

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