Fungsi WdfDeviceWdmDispatchIrpToIoQueue (wdfdevice.h)

Artikel
08/08/2023

[Berlaku untuk KMDF dan UMDF]

Metode WdfDeviceWdmDispatchIrpToIoQueue meneruskan IRP ke antrean I/O tertentu.

Sintaks

NTSTATUS WdfDeviceWdmDispatchIrpToIoQueue(
  [in] WDFDEVICE Device,
  [in] PIRP      Irp,
  [in] WDFQUEUE  Queue,
  [in] ULONG     Flags
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in] Irp

Penunjuk ke struktur IRP.

[in] Queue

Handel ke objek antrean kerangka kerja.

[in] Flags

Bitwise ORdari bendera WDF_DISPATCH_IRP_TO_IO_QUEUE_FLAGS-typed.

Nilai kembali

Metode WdfDeviceWdmDispatchIrpToIoQueue 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 atau fungsi panggilan balik EvtDeviceWdmIrpPreprocess yang disebut WdfDeviceWdmDispatchIrpToIoQueue.

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

Driver memanggil WdfDeviceWdmDispatchIrpToIoQueue untuk menentukan antrean target untuk IRP masuk.

Driver dapat memanggil metode ini dari rutinitas panggilan balik EvtDeviceWdmIrpPreprocess atau dari panggilan balik EvtDeviceWdmIrpDispatch-nya .

Jika driver memanggil WdfDeviceWdmDispatchIrpToIoQueue dari dalam fungsi panggilan balik EvtDeviceWdmIrpPreprocess , driver harus memanggil IoSkipCurrentIrpStackLocation atau IoCopyCurrentIrpStackLocationToNext sebelum memanggil WdfDeviceWdmDispatchIrpToIoQueue.

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), FwdIrpToIoQueueValid(kmdf)

Lihat juga

EvtDeviceWdmIrpDispatch

EvtDeviceWdmIrpPreprocess

Bagikan melalui