Share via

Función UdecxWdfDeviceAddUsbDeviceEmulation (udecxwdfdevice.h)

  • Artículo

Inicializa un objeto de dispositivo de marco para admitir operaciones relacionadas con un controlador de 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 mediante una llamada 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.

Comentarios

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 la llamada a establecer 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 concentrador raíz, como controlar varias colas necesarias para procesar las solicitudes IOCTL enviadas al dispositivo USB conectado.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10
Servidor mínimo compatible Windows Server 2016
Plataforma de destino Windows
Versión mínima de KMDF 1.15
Encabezado udecxwdfdevice.h (incluir Udecx.h)
Library Udecxstub.lib
IRQL PASSIVE_LEVEL

Consulte también

Arquitectura: emulación de dispositivos USB (UDE)

Escritura de un controlador de cliente UDE