Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 in neueren Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]
Die OnIoCanceledOnQueue-Ereignisrückruffunktion eines Treibers informiert den Treiber darüber, dass eine E/A-Anforderung abgebrochen wurde, während sie sich in einer E/A-Warteschlange befand.
Syntax
void OnIoCanceledOnQueue(
[in] IWDFIoQueue *pWdfQueue,
[in] IWDFIoRequest *pWdfRequest
);
Parameter
[in] pWdfQueue
Ein Zeiger auf die IWDFIoQueue-Schnittstelle für die E/A-Warteschlange, in der sich die E/A-Anforderung befand, als sie abgebrochen wurde.
[in] pWdfRequest
Ein Zeiger auf die IWDFIoRequest-Schnittstelle für die E/A-Anforderung.
Rückgabewert
Keine
Bemerkungen
Ein Treiber registriert die IQueueCallbackIoCanceledOnQueue-Schnittstelle und die OnIoCanceledOnQueue-Rückruffunktion einer E/A-Warteschlange, wenn der Treiber IWDFDevice::CreateIoQueue aufruft. Weitere Informationen zum Registrieren der Schnittstelle finden Sie unter IQueueCallbackIoCanceledOnQueue.
Wenn ein Treiber eine OnIoCanceledOnQueue-Rückruffunktion für eine E/A-Warteschlange registriert, ruft das Framework die Rückruffunktion auf, wenn ein Anforderungshandler eine E/A-Anforderung von einer E/A-Warteschlange empfängt, ruft der Treiber IWDFIoRequest::ForwardToIoQueue oder IWDFIoRequest2::Requeue auf, um die Anforderung erneut an die E/A-Warteschlange zu stellen, für die die OnIoCanceledOnQueue-Rückruffunktion registriert ist. und der zugeordnete E/A-Vorgang wird anschließend abgebrochen.
Nachdem das Framework die Rückruffunktion OnIoCanceledOnQueue aufgerufen hat , besitzt der Treiber das Anforderungsobjekt und muss daher die Anforderung abbrechen .
Das Framework ruft die OnIoCanceledOnQueue-Rückruffunktion des Treibers nicht für E/A-Anforderungen auf, die das Framework nie an den Treiber übermittelt hat.
Das Framework ruft eine OnIoCanceledOnQueue-Rückruffunktion auf, sobald festgestellt wird, dass eine E/A-Anforderung abgebrochen wurde, unabhängig von der Verteilmethode , die der Treiber für die E/A-Warteschlange festgelegt hat. Daher kann das Framework eine OnIoCanceledOnQueue-Rückruffunktion für eine Anforderung in einer Warteschlange aufrufen, die sequenzielle Verteilung verwendet, auch wenn der Treiber derzeit eine andere Anforderung aus der Warteschlange besitzt.
Weitere Informationen zur OnIoCanceledOnQueue-Rückruffunktion finden Sie unter Abbrechen von E/A-Anforderungen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform | Desktop |
| UMDF-Mindestversion | 1.9 |
| Kopfzeile | wudfddi.h (include Wudfddi.h) |