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

  • Статья

Инициализирует объект устройства платформы для поддержки операций, связанных с контроллером узла и виртуальным USB-устройством, подключенным к контроллеру.

Синтаксис

NTSTATUS UdecxWdfDeviceAddUsbDeviceEmulation(
       WDFDEVICE                WdfDevice,
  [in] PUDECX_WDF_DEVICE_CONFIG Config
);

Параметры

WdfDevice

Дескриптор объекта устройства платформы, полученный драйвером клиента при предыдущем вызове WdfDeviceCreate.

[in] Config

Указатель на структуру UDECX_WDF_DEVICE_CONFIG , инициализированную драйвером клиента путем вызова UDECX_WDF_DEVICE_CONFIG_INIT.

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

Метод возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае этот метод может вернуть соответствующий код ошибки NTSTATUS .

Комментарии

Драйвер клиента UDE для эмулированного хост-контроллера и USB-устройство должны вызывать этот метод после вызова WdfDeviceCreate .

Во время этого вызова также регистрируются реализации обратного вызова событий, предоставляемые драйвером клиента. Предоставьте указатели функций на эти функции, задав соответствующие члены UDECX_WDF_DEVICE_CONFIG.

Метод делает объект устройства платформы способным выполнять операции, связанные с контроллером и его корневым концентратором, например обрабатывать различные очереди, необходимые для обработки запросов IOCTL, отправленных на подключенное USB-устройство.

Требования

Требование Значение
Минимальная версия клиента Windows 10
Минимальная версия сервера Windows Server 2016
Целевая платформа Windows
Минимальная версия KMDF 1.15
Верхняя часть udecxwdfdevice.h (включая Udecx.h)
Библиотека Udecxstub.lib
IRQL PASSIVE_LEVEL

См. также раздел

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

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