WdfRequestCancelSentRequest-Funktion (wdfrequest.h)

Artikel
02/27/2024

[Gilt für KMDF und UMDF]

Die WdfRequestCancelSentRequest-Methode versucht, eine E/A-Anforderung abzubrechen, die der Aufrufer zuvor an ein E/A-Ziel übermittelt hat.

Syntax

BOOLEAN WdfRequestCancelSentRequest(
  [in] WDFREQUEST Request
);

Parameter

[in] Request

Ein Handle für ein Frameworkanforderungsobjekt.

Rückgabewert

WdfRequestCancelSentRequest gibt TRUE zurück, wenn die Abbruchanforderung erfolgreich an das E/A-Ziel des Treibers übermittelt wird. Diese Methode gibt FALSE zurück, wenn die Anforderung bereits abgeschlossen oder abgebrochen wurde oder wenn der E/A-Zieltreiber WdfRequestMarkCancelable oder WdfRequestMarkCancelableEx nicht aufgerufen hat.

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

Ein Treiber kann WdfRequestCancelSentRequest aufrufen, um zu versuchen, eine E/A-Anforderung, die er zuvor durch Aufrufen von WdfRequestSend an ein E/A-Ziel gesendet hatte, abzubrechen.

Wenn sich die Anforderung in der E/A-Zielwarteschlange befindet, bricht das Framework die Anforderung ab. Wenn das Framework die Anforderung bereits an den Treiber des E/A-Ziels übermittelt hat und dieser Treiber WdfRequestMarkCancelable oder WdfRequestMarkCancelableEx aufgerufen hat, um das Abbrechen zu aktivieren, ruft das Framework die EvtRequestCancel-Rückruffunktion dieses Treibers auf. Wenn der Treiber des Ziels nicht WdfRequestMarkCancelable oder WdfRequestMarkCancelableEx aufgerufen hat, wird die Anforderung erst abgebrochen, wenn die Anforderung abgebrochen werden kann.

Wenn der Treiber eine CompletionRoutine-Rückruffunktion für die Anforderung registriert hat, ruft das Framework die Rückruffunktion auf, nachdem die Anforderung abgebrochen wurde.

Wenn Ihr Treiber WdfRequestCancelSentRequest aufruft, muss er in der Regel die Verweisanzahl des Anforderungsobjekts erhöhen. Weitere Informationen finden Sie unter Synchronisieren des Abbruchs von gesendeten Anforderungen.

Weitere Informationen zum Abbruch von Anforderungen finden Sie unter Abbrechen von E/A-Anforderungen.

Beispiele

Das folgende Codebeispiel stammt aus dem kmdf_fx2 Beispieltreibers. Dieses Beispiel ist eine EvtIoStop-Rückruffunktion . Da dieser Treiber jede Anforderung an sein E/A-Ziel sendet, ruft die EvtIoStop-RückruffunktionWdfRequestCancelSentRequest auf, wenn das Gerät entfernt wurde.

VOID
OsrFxEvtIoStop(
    IN WDFQUEUE  Queue,
    IN WDFREQUEST  Request,
    IN ULONG  ActionFlags
    )
{
    UNREFERENCED_PARAMETER(Queue);

    if (ActionFlags & WdfRequestStopActionSuspend) {
        WdfRequestStopAcknowledge(Request, FALSE);
    } else if (ActionFlags & WdfRequestStopActionPurge) {
        WdfRequestCancelSentRequest(Request);
    }
    return;
}

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfrequest.h (include Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), EvtIoStopCancel(kmdf), EvtIoStopCompleteOrStopAck(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)