IWDFIoRequest::CancelSentRequest-Methode (wudfddi.h)
[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]
Die CancelSentRequest Methode versucht, die E/A-Anforderung abzubrechen, die der Treiber zuvor an ein E/A-Ziel übermittelt hat.
Syntax
BOOL CancelSentRequest();
Rückgabewert
CancelSentRequest gibt einen BOOL-Wert zurück, der angibt, ob die Anforderung erfolgreich an den Besitzer der Anforderung übermittelt wurde. TRUE gibt an, dass die Anforderung erfolgreich übermittelt wurde. FALSE- gibt an, dass die Anforderung nicht erfolgreich zugestellt wurde.
Bemerkungen
Ein Treiber kann CancelSentRequest- aufrufen, um zu versuchen, die E/A-Anforderung abzubrechen, die er zuvor an ein E/A-Ziel gesendet hat, indem die IWDFIoRequest::Send-Methode aufgerufen wird.
Wenn sich die Anforderung in der E/A-Zielwarteschlange befindet, bricht das Framework die Anforderung ab. Wenn das Framework die Anforderung bereits an den I/O-Zieltreiber übermittelt hat und dieser Treiber zuvor IWDFIoRequest::MarkCancelable aufgerufen hat, um das Abbrechen zu ermöglichen, ruft das Framework die IRequestCallbackCancel::OnCancel-Methode auf. Wenn der Treiber des Ziels IWDFIoRequest::MarkCancelablenicht aufgerufen hat, wird die Anforderung erst abgebrochen, wenn die Anforderung anschließend abgebrochen werden kann.
Wenn der Treiber zuvor die IRequestCallbackRequestCompletion Schnittstelle für die Abschlussroutine der Anforderung registriert hat, ruft das Framework die Abschlussroutine auf, nachdem die Anforderung abgebrochen wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform- | Desktop |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |
Siehe auch
IRequestCallbackCancel::OnCancel