Share via

EVT_UDECX_USB_DEVICE_ENDPOINT_ADD función de devolución de llamada (udecxusbdevice.h)

  • Artículo

La extensión de clase de emulación de dispositivo USB (UdeCx) invoca esta función de devolución de llamada para solicitar al controlador cliente que cree un punto de conexión dinámico en el dispositivo USB virtual.

Sintaxis

EVT_UDECX_USB_DEVICE_ENDPOINT_ADD EvtUdecxUsbDeviceEndpointAdd;

NTSTATUS EvtUdecxUsbDeviceEndpointAdd(
  [in] UDECXUSBDEVICE UdecxUsbDevice,
  [in] PUDECX_USB_ENDPOINT_INIT_AND_METADATA EndpointToCreate
)
{...}

Parámetros

[in] UdecxUsbDevice

Identificador del objeto de dispositivo UDE para el que el controlador cliente crea un punto de conexión. El controlador creó este objeto en una llamada anterior a UdecxUsbDeviceCreate.

[in] EndpointToCreate

Puntero a una estructura de UDECX_USB_ENDPOINT_INIT_AND_METADATA que contiene el descriptor de punto de conexión.

Valor devuelto

Si la operación se realiza correctamente, la función de devolución de llamada debe devolver STATUS_SUCCESS u otro valor de estado para el que NT_SUCCESS(status) es igual a TRUE.

Comentarios

El controlador cliente registró esta función de devolución de llamada en una llamada anterior a UdecxUsbDeviceInitSetStateChangeCallbacks proporcionando un puntero de función a su implementación.

En la implementación, se espera que el controlador de cliente cree el punto de conexión mediante una llamada a UdecxUsbEndpointCreate mediante el uso de los parámetros de inicialización (UDECXUSBENDPOINT_INIT) pasados por la extensión de clase en la estructura UDECX_USB_ENDPOINT_INIT_AND_METADATA .

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 udecxusbdevice.h (incluya Udecx.h)
IRQL PASSIVE_LEVEL

Consulte también

Arquitectura: emulación de dispositivos USB (UDE)

UdecxUsbEndpointCreate

Escritura de un controlador de cliente UDE