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) |