Freigeben über


EVT_WDF_REQUEST_CANCEL Rückruffunktion (wdfrequest.h)

[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 zu einem Framework-Anforderungsobjekt, das die E/A-Anforderung darstellt, die abgebrochen wird.

Rückgabewert

Nichts

Bemerkungen

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

Wenn das Framework die EvtRequestCancel Callbackfunktion des Treibers aufruft, muss der Treiber die Anforderung abbrechen:

  1. Beenden oder beenden Sie die Verarbeitung der Anforderung zusammen mit Unteranforderungen, die sie möglicherweise erstellt haben.
  2. Rufen Sie WdfRequestCompleteauf, und geben Sie einen Statuswert von STATUS_CANCELLED an.
Weitere Informationen zu dieser Rückruffunktion finden Sie unter Abbrechen von E/A-Anforderungen.

Anforderungen

Anforderung Wert
Zielplattform- Universal
Minimale KMDF-Version 1.0
Mindest-UMDF-Version 2.0
Header- wdfrequest.h (include Wdf.h)
IRQL- <=DISPATCH_LEVEL

Siehe auch

WdfRequestComplete-

WdfRequestMarkCancelable

WdfRequestMarkCancelableEx-