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 de 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

Ninguno

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 que 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 llamando a WdfIoQueuePurge. Esta llamada es asincrónica y el río del cliente debe llamar a UdecxUsbEndpointPurgeComplete.

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

Consulte también

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

administración de colas de E/S

Escribir un controlador de cliente UDE