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

La extensión de clase de emulación de dispositivo USB (UdeCx) invoca esta función de devolución de llamada para cambiar la configuración seleccionando una configuración alternativa, deshabilitando los puntos de conexión actuales o agregando puntos de conexión dinámicos.

Sintaxis

EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE EvtUdecxUsbDeviceEndpointsConfigure;

void EvtUdecxUsbDeviceEndpointsConfigure(
  [in] UDECXUSBDEVICE UdecxUsbDevice,
  [in] WDFREQUEST Request,
  [in] PUDECX_ENDPOINTS_CONFIGURE_PARAMS Params
)
{...}

Parámetros

[in] UdecxUsbDevice

Identificador del objeto de dispositivo UDE. El controlador cliente creó este objeto en una llamada anterior a UdecxUsbDeviceCreate.

[in] Request

Identificador de un objeto de solicitud de marco que representa la solicitud.

[in] Params

Puntero a una estructura de UDECX_ENDPOINTS_CONFIGURE_PARAMS que describe las opciones de configuración.

Valor devuelto

None

Observaciones

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.

La extensión de clase invoca esta función de devolución de llamada para solicitar al controlador cliente que configure uno o varios puntos de conexión nuevos en hardware, o informa al controlador cuando uno o varios puntos de conexión existentes ya no se usan.

Después de crear puntos de conexión, para cada nuevo punto de conexión, el controlador de cliente debe llamar a UdecxUsbEndpointSetWdfIoQueue antes de completar la solicitud.

Después de liberar puntos de conexión, el controlador cliente no debe usar objetos de cola de marco asociados a los puntos de conexión. La extensión de clase considera esas colas como purgadas para evitar solicitudes futuras.

La extensión de clase también puede solicitar un nuevo valor de configuración o una configuración alternativa a través de esta devolución de llamada.

Esta llamada es asincrónica. El controlador cliente debe indicar la finalización con el estado completando la solicitud pasada por la extensión de clase.

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	<=DISPATCH_LEVEL

Consulte también

Arquitectura: emulación de dispositivos USB (UDE)

UdecxUsbEndpointSetWdfIoQueue

Escritura de un controlador de cliente UDE