Функция 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
целевая платформа Виндоус
минимальная версия KMDF 1.15
заголовка udecxwdfdevice.h (include Udecx.h)
библиотеки Udecxstub.lib
IRQL PASSIVE_LEVEL

См. также

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

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