Compartir a través de


Función UdecxWdfDeviceAddUsbDeviceEmulation (udecxwdfdevice.h)

Inicializa un objeto de dispositivo de marco para admitir operaciones relacionadas con un controlador host y un dispositivo USB virtual conectado al controlador.

Sintaxis

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

Parámetros

WdfDevice

Identificador del objeto de dispositivo de marco que el controlador cliente recuperó en la llamada anterior a WdfDeviceCreate.

[in] Config

Puntero a una estructura de UDECX_WDF_DEVICE_CONFIG que inicializó el controlador cliente llamando a UDECX_WDF_DEVICE_CONFIG_INIT.

Valor devuelto

El método devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, este método podría devolver un código de error NTSTATUS adecuado.

Observaciones

El controlador cliente UDE para el controlador host emulado y el dispositivo USB deben llamar a este método después de la llamada WdfDeviceCreate.

Durante esta llamada, también se registran las implementaciones de devolución de llamada de eventos proporcionadas por el controlador cliente. Proporcione punteros de función a esas funciones mediante una llamada al establecimiento de los miembros adecuados de UDECX_WDF_DEVICE_CONFIG.

El método hace que el objeto de dispositivo de marco sea capaz de realizar operaciones relacionadas con un controlador y su centro raíz, como controlar varias colas necesarias para procesar las solicitudes IOCTL enviadas al dispositivo USB conectado.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 10
servidor mínimo admitido Windows Server 2016
de la plataforma de destino de Windows
versión mínima de KMDF 1.15
encabezado de udecxwdfdevice.h (incluya Udecx.h)
biblioteca de Udecxstub.lib
irQL PASSIVE_LEVEL

Consulte también

Arquitectura de : de emulación de dispositivos USB (UDE)

Escribir un controlador de cliente UDE