EVT_WDF_REQUEST_CANCEL Rückruffunktion (wdfrequest.h)

  • Artikel

[Gilt für KMDF und UMDF]

Die EvtRequestCancel-Ereignisrückruffunktion eines Treibers verarbeitet Vorgänge, die ausgeführt werden müssen, wenn eine E/A-Anforderung abgebrochen wird.

Syntax

EVT_WDF_REQUEST_CANCEL EvtWdfRequestCancel;

void EvtWdfRequestCancel(
  [in] WDFREQUEST Request
)
{...}

Parameter

[in] Request

Ein Handle für ein Frameworkanforderungsobjekt, das die E/A-Anforderung darstellt, die abgebrochen wird.

Rückgabewert

Keine

Bemerkungen

Um eine EvtRequestCancel-Rückruffunktion zu registrieren, muss der Treiber WdfRequestMarkCancelable oder WdfRequestMarkCancelableEx aufrufen.

Wenn das Framework die EvtRequestCancel-Rückruffunktion Ihres Treibers aufruft, muss die Anforderung vom Treiber abgebrochen werden:

  1. Beenden oder beenden Sie die Verarbeitung der Anforderung zusammen mit möglicherweise erstellten Unteranforderungen.
  2. Rufen Sie WdfRequestComplete auf, und geben Sie den status Wert STATUS_CANCELLED an.
Weitere Informationen zu dieser Rückruffunktion finden Sie unter Abbrechen von E/A-Anforderungen.

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile wdfrequest.h (einschließen von Wdf.h)
IRQL <=DISPATCH_LEVEL

Weitere Informationen

WdfRequestComplete

WdfRequestMarkCancelable

WdfRequestMarkCancelableEx