IWDFIoRequest2::IsCanceled-Methode (wudfddi.h)

  • Artikel

[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

Weitere Informationen

IRequestCallbackCancel::OnCancel

IWDFIoRequest2

IWDFIoRequest::MarkCancelable

IWDFIoRequest::UnmarkCancelable