EVT_UDECX_USB_ENDPOINT_PURGE función de devolución de llamada (udecxusbendpoint.h)

La extensión de clase de emulación de dispositivo USB (UdeCx) invoca esta función de devolución de llamada para detener las solicitudes de E/S en cola del punto de conexión y cancelar las solicitudes sin procesar.

Sintaxis

EVT_UDECX_USB_ENDPOINT_PURGE EvtUdecxUsbEndpointPurge;

void EvtUdecxUsbEndpointPurge(
  [in] UDECXUSBENDPOINT UdecxUsbEndpoint
)
{...}

Parámetros

[in] UdecxUsbEndpoint

Identificador de un objeto de punto de conexión UDE que representa el punto de conexión para el que se deben cancelar las solicitudes de E/S. El controlador cliente recuperó este puntero en la llamada anterior a UdecxUsbEndpointCreate.

Valor devuelto

None

Observaciones

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

En la implementación, se requiere el controlador de cliente para asegurarse de que se han completado todas las E/S reenviadas desde la cola del punto de conexión y se produce un error en la solicitud de E/S reenviada recientemente, hasta que UdeCx invoca EVT_UDECX_USB_ENDPOINT_START. Normalmente, esas tareas se logran mediante una llamada a WdfIoQueuePurge. Esta llamada es asincrónica y el río del cliente debe llamar a UdecxUsbEndpointPurgeComplete.

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	udecxusbendpoint.h (incluir Udecx.h)
IRQL	<=DISPATCH_LEVEL

Consulte también

Arquitectura: emulación de dispositivos USB (UDE)

Administración de colas de E/S

Escritura de un controlador de cliente UDE