[适用于 KMDF 和 UMDF]
WdfDeviceWdmDispatchIrp 方法将调度的 IRP 从 EvtDeviceWdmIrpDispatch返回给框架。
语法
NTSTATUS WdfDeviceWdmDispatchIrp(
[in] WDFDEVICE Device,
[in] PIRP Irp,
[in] WDFCONTEXT DispatchContext
);
参数
[in] Device
框架设备对象的句柄。
[in] Irp
指向 IRP 结构的指针。
[in] DispatchContext
驱动程序在 EvtDeviceWdmIrpDispatch 回调中收到的调度上下文参数。
返回值
WdfDeviceWdmDispatchIrp 方法返回框架或驱动程序在处理 IRP 时提供的 NTSTATUS 值。 驱动程序必须将此返回值用作 EvtDeviceWdmIrpDispatch 回调函数的返回值,该函数调用 WdfDeviceWdmDispatchIrp。
如果 KMDF 驱动程序提供无效的对象句柄,则会发生 bug 检查。 如果 UMDF 驱动程序提供无效句柄,驱动程序主机进程将终止。
注解
如果驱动程序提供 EvtDeviceWdmIrpDispatch 回调函数,则可以从回调函数中调用 WdfDeviceWdmDispatchIrp,以将 IRP 返回到框架进行默认处理,而不是将其调度到特定队列。
有关在 IRP 到达时指定队列的详细信息,请参阅 将 IRP 调度到 I/O 队列。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 普遍 |
| 最低 KMDF 版本 | 1.11 |
| 最低 UMDF 版本 | 2.17 |
| 标头 | wdfdevice.h (包括 Wdf.h) |
| 图书馆 | Wdf01000.sys(KMDF):WUDFx02000.dll (UMDF) |
| IRQL | <= DISPATCH_LEVEL |
| DDI 符合性规则 | DriverCreate(kmdf) |