WdfRequestWdmGetIrp-Funktion (wdfrequest.h)

Artikel
02/07/2025

[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 zu einem Framework-Anforderungsobjekt.

Rückgabewert

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

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Bemerkungen

Der Treiber darf nicht auf die IRP-Struktur einer Anforderung zugreifen, nachdem die E/A-Anforderungabgeschlossen hat.

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

Beispiele

Das folgende Codebeispiel ist Teil einer EvtIoDeviceControl- Rückruffunktion, die die WDM-IRP abruft, die einer E/A-Anforderung zugeordnet ist, und ruft dann IoGetNextIrpStackLocation- auf, um den I/O-Stapelspeicherort des nächsten 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-	Universal
Minimale KMDF-Version	1.0
Header-	wdfrequest.h (include Wdf.h)
Library	Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL-	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Siehe auch

WdfRequestGetParameters

Freigeben über