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 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:
- Beenden oder beenden Sie die Verarbeitung der Anforderung zusammen mit möglicherweise erstellten Unteranforderungen.
- Rufen Sie WdfRequestComplete auf, und geben Sie den status Wert STATUS_CANCELLED an.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfrequest.h (einschließen von Wdf.h) |
| IRQL | <=DISPATCH_LEVEL |