EVT_UDECX_USB_ENDPOINT_PURGE funzione di callback (udecxusbendpoint.h)

L'estensione della classe di emulazione del dispositivo USB (UdeCx) richiama questa funzione di callback per interrompere l'accodamento delle richieste di I/O alla coda dell'endpoint e annullare le richieste non elaborate.

Sintassi

EVT_UDECX_USB_ENDPOINT_PURGE EvtUdecxUsbEndpointPurge;

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

Parametri

[in] UdecxUsbEndpoint

Handle a un oggetto endpoint UDE che rappresenta l'endpoint per il quale le richieste di I/O devono essere annullate. Il driver client ha recuperato questo puntatore nella chiamata precedente a UdecxUsbEndpointCreate.

Valore restituito

nessuno

Osservazioni

Il driver client ha registrato questa funzione di callback in una chiamata precedente a UdecxUsbEndpointInitSetCallbacks fornendo un puntatore a funzione alla relativa implementazione.

Nell'implementazione, il driver client è necessario per assicurarsi che tutte le operazioni di I/O inoltrate dalla coda dell'endpoint siano state completate e che la richiesta di I/O appena inoltrata abbia esito negativo, fino a quando UdeCx non richiama EVT_UDECX_USB_ENDPOINT_START. In genere, queste attività vengono eseguite chiamando WdfIoQueuePurge. Questa chiamata è asincrona e il fiume client deve chiamare UdecxUsbEndpointPurgeComplete.

Requisiti

Requisito Valore
Client minimo supportato Windows 10
Server minimo supportato Windows Server 2016
Piattaforma di destinazione Windows
Versione KMDF minima 1.15
Intestazione udecxusbendpoint.h (include Udecx.h)
IRQL <=DISPATCH_LEVEL

Vedi anche

Architettura: Emulazione dispositivo USB (UDE)

Gestione delle code di I/O

Scrivere un driver client UDE