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

IRequestCallbackRequestCompletion

IWDFIoRequest

IWDFIoRequest::MarkCancelable

IWDFIoRequest::Send