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. 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 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 Abbruchanforderung 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 übermittelt wurde.
Hinweise
Ein Treiber kann CancelSentRequest aufrufen, um zu versuchen, die E/A-Anforderung, die er zuvor an ein E/A-Ziel gesendet hat, durch Aufrufen der IWDFIoRequest::Send-Methode abzubrechen.
Wenn sich die Anforderung in der E/A-Zielwarteschlange befindet, bricht das Framework die Anforderung ab. Wenn das Framework die Anforderung bereits an den Treiber des E/A-Ziels übermittelt hat und dieser Treiber zuvor IWDFIoRequest::MarkCancelable aufgerufen hat, um das Abbrechen zu aktivieren, ruft das Framework die IRequestCallbackCancel::OnCancel-Methode dieses Treibers auf. Wenn der Treiber des Ziels IWDFIoRequest::MarkCancelable nicht 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 Vervollständigungsroutine auf, nachdem die Anforderung abgebrochen wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform | Desktop |
| UMDF-Mindestversion | 1.5 |
| Kopfzeile | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |
Weitere Informationen
IRequestCallbackCancel::OnCancel