EVT_WDFDEVICE_WDM_IRP_PREPROCESS回调函数 （wdfdevice.h）
[仅适用于 KMDF]
驱动程序的 EvtDeviceWdmIrpPreprocess 事件回调函数在框架处理 IRP 之前接收 IRP。
语法
EVT_WDFDEVICE_WDM_IRP_PREPROCESS EvtWdfdeviceWdmIrpPreprocess;
NTSTATUS EvtWdfdeviceWdmIrpPreprocess(
[in] WDFDEVICE Device,
[in, out] PIRP Irp
)
{...}
参数
[in] Device
框架设备对象的句柄。
[in, out] Irp
指向 IRP 结构的指针。
返回值
EvtDeviceWdmIrpPreprocess 回调函数必须：
- 将 IRP 的 IoStatus.Status 成员设置为STATUS_SUCCESS或其他状态值，NT_SUCCESS（status） 等于 TRUE，并返回相同的值（调用 IoCompleteRequest后），如果回调函数成功完成收到的 IRP。
- 将 IRP IoStatus.Status 成员设置为 NT_SUCCESS（status） 等于 FALSE的状态值，如果回调函数检测到错误，则返回相同的值（调用 IoCompleteRequest 后）。
- 如果回调函数调用 IoMarkIrpPending，则返回STATUS_PENDING。
- 如果回调函数调用该方法，则返回 WdfDeviceWdmDispatchPreprocessedIrp 方法返回的值。
言论
若要注册 EvtDeviceWdmIrpPreprocess 回调函数，驱动程序必须调用 WdfDeviceInitAssignWdmIrpPreprocessCallback。
驱动程序可以使用 EvtDeviceWdmIrpPreprocess 回调函数执行以下任一或全部作：
- 按照 WDM 规则处理 IRP，处理框架不支持的 IRP。
- 在框架处理 IRP 之前预处理 IRP。
- 设置完成例程，以便驱动程序可以在框架处理后处理 IRP。
如果希望框架随后像以前一样处理 IRP（如果尚未调用 EvtDeviceWdmIrpPreprocess 回调函数），回调函数必须调用 WdfDeviceWdmDispatchPreprocessedIrp 才能将 IRP 返回到框架。
如果驱动程序注册 EvtDeviceWdmIrpPreprocess 回调函数，则框架会将额外的 I/O 堆栈位置 添加到回调函数接收的 IRP 中。 额外的 I/O 堆栈位置允许回调函数在调用 WdfDeviceWdmDispatchPreprocessedIrp之前设置 IoCompletion 例程。
调用线程的 IRQL 调用 EvtDeviceWdmIrpPreprocess 回调函数。 IRQL 由框架传递给 EvtDeviceWdmIrpPreprocess的 IRP 类型确定。 例如，如果 PnP 管理器在 IRQL = PASSIVE_LEVEL 发送 IRP_MN_QUERY_DEVICE_RELATIONS，则框架会在 IRQL = PASSIVE_LEVEL调用 EvtDeviceWdmIrpPreprocess。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 标头 | wdfdevice.h （包括 Wdf.h） |
| IRQL | <=DISPATCH_LEVEL |