EVT_UDECX_USB_ENDPOINT_PURGE Rückruffunktion (udecxusbendpoint.h)

Die USB-Geräteemulationsklassenerweiterung (UdeCx) ruft diese Rückruffunktion auf, um die Warteschlange von E/A-Anforderungen an die Warteschlange des Endpunkts zu beenden und nicht verarbeitete Anforderungen abzubrechen.

Syntax

EVT_UDECX_USB_ENDPOINT_PURGE EvtUdecxUsbEndpointPurge;

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

Parameter

[in] UdecxUsbEndpoint

Ein Handle für ein UDE-Endpunktobjekt, das den Endpunkt darstellt, für den E/A-Anforderungen abgebrochen werden müssen. Der Clienttreiber hat diesen Zeiger im vorherigen Aufruf von UdecxUsbEndpointCreate abgerufen.

Rückgabewert

Keine

Bemerkungen

Der Clienttreiber hat diese Rückruffunktion in einem vorherigen Aufruf von UdecxUsbEndpointInitSetCallbacks registriert, indem er einen Funktionszeiger auf seine Implementierung angibt.

In der Implementierung muss der Clienttreiber sicherstellen, dass alle von der Warteschlange des Endpunkts weitergeleiteten E/A-Vorgänge abgeschlossen wurden und dass die neu weitergeleitete E/A-Anforderung fehlschlägt, bis UdeCx EVT_UDECX_USB_ENDPOINT_START aufruft. In der Regel werden diese Aufgaben durch Aufrufen von WdfIoQueuePurge erreicht. Dieser Aufruf ist asynchron, und der Clientfluss muss UdecxUsbEndpointPurgeComplete aufrufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10
Unterstützte Mindestversion (Server) Windows Server 2016
Zielplattform Windows
KMDF-Mindestversion 1.15
Kopfzeile udecxusbendpoint.h (include Udecx.h)
IRQL <=DISPATCH_LEVEL

Weitere Informationen

Architektur: USB-Geräteemulation (UDE)

Verwalten von E/A-Warteschlangen

Schreiben eines UDE-Clienttreibers