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. 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 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.
Bemerkungen
Wenn Ihr Treiber nicht IWDFIoRequest::MarkCancelable aufgerufen hat, um eine IRequestCallbackCancel::OnCancel Rückruffunktion zu registrieren, aber wenn Ihr Treiber ermitteln soll, ob der E/A-Manager versucht hat, eine E/A-Anforderung abzubrechen, kann der Treiber IsCanceledaufrufen.
Ein Treiber kann IsCanceled nur für eine Anforderung aufrufen, wenn der Treiber die E/A-Anforderung besitzt. Wenn der Treiber IWDFIoRequest::MarkCancelableaufgerufen hat, muss er IWDFIoRequest::UnmarkCancelable aufrufen, bevor IsCanceledaufgerufen wird.
Wenn IsCanceledTRUEzurückgibt, sollte der Treiber die Anforderung abbrechen, indem IWDFIoRequest::Complete aufgerufen wird, wobei der parameter CompletionStatus auf HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED) festgelegt ist.
Weitere Informationen zu IsCanceledfinden Sie unter Abbrechen von E/A-Anforderungen.
Beispiele
Wenn IsCanceled im folgenden CodebeispielTRUE-zurückgibt, schließt der Treiber die E/A-Anforderung durch Aufrufen IWDFIoRequest::Complete mit einem Abschlussstatus von HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED) ab.
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 |
| Mindest-UMDF-Version | 1.9 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |