Функция 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 |