Fungsi WdfRequestWdmGetIrp (wdfrequest.h)

  • Artikel

[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