WdfRequestWdmGetIrp-Funktion (wdfrequest.h)

[Gilt nur für KMDF]

Die WdfRequestWdmGetIrp-Methode gibt die WDM-IRP-Struktur zurück, die einem angegebenen Frameworkanforderungsobjekt zugeordnet ist.

Syntax

PIRP WdfRequestWdmGetIrp(
  [in] WDFREQUEST Request
);

Parameter

[in] Request

Ein Handle für ein Frameworkanforderungsobjekt.

Rückgabewert

WdfRequestWdmGetIrp gibt einen Zeiger auf eine IRP-Struktur zurück.

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

Hinweise

Der Treiber darf nach Abschluss der E/A-Anforderung nicht auf die IRP-Struktur einer Anforderung zugreifen.

Weitere Informationen zu WdfRequestWdmGetIrp finden Sie unter Abrufen von Informationen zu einer E/A-Anforderung.

Beispiele

Das folgende Codebeispiel ist Teil einer EvtIoDeviceControl-Rückruffunktion , die das WDM-IRP abruft, das einer E/A-Anforderung zugeordnet ist, und dann IoGetNextIrpStackLocation aufruft, um den E/A-Stapelspeicherort des nächstniedrigen Treibers abzurufen.

VOID
MyEvtIoDeviceControl(
    IN WDFQUEUE  Queue,
    IN WDFREQUEST  Request,
    IN size_t  OutputBufferLength,
    IN size_t  InputBufferLength,
    IN ULONG  IoControlCode
    )
{
    PIRP  irp = NULL;
    PIO_STACK_LOCATION  nextStack;
...
    irp = WdfRequestWdmGetIrp(Request);
    nextStack = IoGetNextIrpStackLocation(irp);
...
}

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
Kopfzeile wdfrequest.h (include Wdf.h)
Bibliothek Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WdfRequestGetParameters