Fungsi WdfDeviceWdmDispatchIrp (wdfdevice.h)
[Berlaku untuk KMDF dan UMDF]
Metode WdfDeviceWdmDispatchIrp mengembalikan IRP yang dikirim ke kerangka kerja dari EvtDeviceWdmIrpDispatch.
Sintaks
NTSTATUS WdfDeviceWdmDispatchIrp(
[in] WDFDEVICE Device,
[in] PIRP Irp,
[in] WDFCONTEXT DispatchContext
);
Parameter
[in] Device
Handel ke objek perangkat kerangka kerja.
[in] Irp
Penunjuk ke struktur IRP.
[in] DispatchContext
Parameter konteks pengiriman driver yang diterima di panggilan balik EvtDeviceWdmIrpDispatch .
Nilai kembali
Metode WdfDeviceWdmDispatchIrp mengembalikan nilai NTSTATUS yang disediakan kerangka kerja atau driver sebagai akibat dari pemrosesan IRP. Driver harus menggunakan nilai pengembalian ini sebagai nilai pengembalian untuk fungsi panggilan balik EvtDeviceWdmIrpDispatch yang disebut WdfDeviceWdmDispatchIrp.
Pemeriksaan bug terjadi jika driver KMDF menyediakan handel objek yang tidak valid. Jika driver UMDF menyediakan handel yang tidak valid, proses host driver berakhir.
Keterangan
Jika driver Anda menyediakan fungsi panggilan balik EvtDeviceWdmIrpDispatch , Anda dapat memanggil WdfDeviceWdmDispatchIrp dari dalam fungsi panggilan balik untuk mengembalikan IRP ke kerangka kerja untuk pemrosesan default alih-alih mengirimkannya ke antrean tertentu.
Untuk informasi selengkapnya tentang menentukan antrean untuk runtime integrasi saat mereka tiba, lihat Mengirimkan IRP ke Antrean I/O.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1.11 |
| Versi UMDF minimum | 2.17 |
| Header | wdfdevice.h (termasuk Wdf.h) |
| Pustaka | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <= DISPATCH_LEVEL |
| Aturan kepatuhan DDI | DriverCreate(kmdf) |