IWDFIoRequest2::IsCanceled-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 für neuere 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 IsCanceled-Methode bestimmt, ob der E/A-Manager versucht hat, eine E/A-Anforderung abzubrechen.
Syntax
BOOL IsCanceled();
Rückgabewert
IsCanceled gibt TRUE zurück, wenn der E/A-Manager versucht hat, die E/A-Anforderung abzubrechen. Diese Methode gibt FALSE aus einem der folgenden Gründe zurück:
- Der E/A-Manager hat nicht versucht, die Anforderung abzubrechen.
- Der aufrufende Treiber besitzt die Anforderung nicht.
- Der aufrufende Treiber hat die IWDFIoRequest::MarkCancelable-Methode aufgerufen.
Hinweise
Wenn Ihr Treiber nicht IWDFIoRequest::MarkCancelable aufgerufen hat, um eine IRequestCallbackCancel::OnCancel-Rückruffunktion zu registrieren, aber wenn Ihr Treiber feststellen soll, ob der E/A-Manager versucht hat, eine E/A-Anforderung abzubrechen, kann der Treiber IsCanceled aufrufen.
Ein Treiber kann IsCanceled nur für eine Anforderung aufrufen, wenn der Treiber besitzer der E/A-Anforderung ist. Wenn der Treiber IWDFIoRequest::MarkCancelable aufgerufen hat, muss er IWDFIoRequest::UnmarkCancelable aufrufen, bevor Er IsCanceled aufruft.
Wenn IsCanceled TRUE zurückgibt, sollte ihr Treiber die Anforderung abbrechen, indem er IWDFIoRequest::Complete aufruft, wobei der CompletionStatus-Parameter auf HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED) festgelegt ist.
Weitere Informationen zu IsCanceled finden Sie unter Abbrechen von E/A-Anforderungen.
Beispiele
Wenn IsCanceled im folgenden Codebeispiel TRUE zurückgibt, schließt der Treiber die E/A-Anforderung ab, indem er IWDFIoRequest::Complete mit einer status von HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED) aufruft.
if (fxRequest2->IsCanceled())
{
fxRequest2->Complete(HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED));
}
...
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) |
| DLL | WUDFx.dll |