Fungsi WdfRequestWdmGetIrp (wdfrequest.h)

Artikel
02/29/2024

[Berlaku untuk KMDF saja]

Metode WdfRequestWdmGetIrp mengembalikan struktur IRP WDM yang terkait dengan objek permintaan kerangka kerja tertentu.

Sintaks

PIRP WdfRequestWdmGetIrp(
  [in] WDFREQUEST Request
);

Parameter

[in] Request

Handel ke objek permintaan kerangka kerja.

Nilai kembali

WdfRequestWdmGetIrp mengembalikan penunjuk ke struktur IRP .

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Keterangan

Driver tidak boleh mengakses struktur IRP permintaan setelah menyelesaikan permintaan I/O.

Untuk informasi selengkapnya tentang WdfRequestWdmGetIrp, lihat Mendapatkan Informasi Tentang Permintaan I/O.

Contoh

Contoh kode berikut adalah bagian dari fungsi panggilan balik EvtIoDeviceControl yang mendapatkan IRP WDM yang terkait dengan permintaan I/O dan kemudian memanggil IoGetNextIrpStackLocation untuk mendapatkan lokasi tumpukan I/O driver yang lebih rendah berikutnya.

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);
...
}

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Header	wdfrequest.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL	<=DISPATCH_LEVEL
Aturan kepatuhan DDI	DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

WdfRequestGetParameters

Bagikan melalui