EVT_UDECX_USB_ENDPOINT_PURGE Rückruffunktion (udecxusbendpoint.h)
Die ERWEITERUNG der USB-Geräteemulationsklasse (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 zu einem 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 UdecxUsbEndpointCreateabgerufen.
Rückgabewert
Nichts
Bemerkungen
Der Clienttreiber hat diese Rückruffunktion in einem vorherigen Aufruf von UdecxUsbEndpointInitSetCallbacks registriert, indem ein Funktionszeiger auf seine Implementierung bereitgestellt wird.
In der Implementierung ist der Clienttreiber erforderlich, um sicherzustellen, dass alle von der Endpunktwarteschlange weitergeleiteten E/A-Vorgänge abgeschlossen wurden und dass die neu weitergeleitete E/A-Anforderung fehlschlägt, bis UdeCx EVT_UDECX_USB_ENDPOINT_STARTaufruft. Normalerweise werden diese Aufgaben durch Aufrufen von WdfIoQueuePurgeerreicht. Dieser Aufruf ist asynchron, und der Clientfluss muss UdecxUsbEndpointPurgeCompleteaufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10 |
| mindestens unterstützte Server- | Windows Server 2016 |
| Zielplattform- | Fenster |
| Minimale KMDF-Version | 1.15 |
| Header- | udecxusbendpoint.h (include Udecx.h) |
| IRQL- | <=DISPATCH_LEVEL |
Siehe auch
Architektur: USB Device Emulation (UDE)