在框架外部处理 WDM IRP

当 I/O 管理器将 I/O 请求数据包 (IRP) 传送到基于框架的驱动程序时，框架会截获 IRP，然后执行以下操作之一：

• 处理 IRP。 例如，框架处理包含 IRP_MJ_PNP 和 IRP_MJ_POWER 主要 I/O 函数代码的 IRP。 处理这些 IRP 时，框架可能通过调用驱动程序的事件回调函数来与驱动程序通信;
• 为 IRP 创建一个框架请求对象，并将请求对象传递到驱动程序的 I/O 队列之一，以便驱动程序可以接收它，通常在请求处理程序中对其进行处理。 框架以这种方式处理读取、写入和设备 I/O 控制请求;
• 如果驱动程序是Filter驱动程序，请将 IRP 传递给下一个较低的驱动程序 ;如果驱动程序不是筛选器驱动程序，则以状态值STATUS_INVALID_DEVICE_REQUEST 完成 IRP，因为 IRP 包含框架不支持的 I/O 函数代码;

有时，驱动程序必须处理框架不支持的 I/O 函数代码。

在极少数情况下，驱动程序可能需要在框架处理 IRP 之前对其进行预处理，或者驱动程序可能需要在框架和较低级别的驱动程序处理完 IRP 之后对其进行后处理。

作为预处理的一部分，驱动程序可能需要将 IRP 转发到特定的 I/O 队列。

对 IRP 进行预处理和后处理

如果驱动程序必须在框架处理 IRP 之前或之后截获 IRP (IRP) I/O 请求数据包，则驱动程序可以调用 WdfDeviceInitAssignWdmIrpPreprocessCallback ，为主要 I/O 函数代码注册 EvtDeviceWdmIrpPreprocess 事件回调函数，或者为与主要代码关联的特定次要 I/O 函数代码注册 EvtDeviceWdmIrpPreprocess 事件回调函数。 随后，每当驱动程序收到包含指定的主要和次要函数代码的 IRP 时，框架就会调用驱动程序的 EvtDeviceWdmIrpPreprocess 回调函数。

EvtDeviceWdmIrpPreprocess 回调函数可以执行预处理 IRP 所需的一切操作，然后它必须调用 WdfDeviceWdmDispatchPreprocessedIrp 将 IRP 返回到框架，除非驱动程序正在处理框架不支持的 IRP。

在驱动程序调用 WdfDeviceWdmDispatchPreprocessedIrp 后，框架将处理 IRP 的方式与驱动程序未提供 EvtDeviceWdmIrpPreprocess 回调函数时处理 IRP 的方式相同。 如果 IRP 的 I/O 函数代码是框架传递给驱动程序的函数代码，驱动程序将再次接收 IRP 作为请求对象。

如果驱动程序需要在较低级别的驱动程序完成 IRP 后处理 IRP，驱动程序的 EvtDeviceWdmIrpPreprocess 回调函数可以调用 IoSetCompletionRoutine 来设置 IoCompletion 例程，然后再调用 WdfDeviceWdmDispatchPreprocessedIrp。

在驱动程序调用 WdfDeviceInitAssignWdmIrpPreprocessCallback 后，框架使 I/O 管理器向所有 IRP 添加额外的 I/O 堆栈位置 ，以便 EvtDeviceWdmIrpPrepPreprocess 回调函数可以设置 IoCompletion 例程。 回调函数必须在调用 WdfDeviceWdmDispatchPreprocessedIrp 之前更新 IRP 的 I/O 堆栈位置指针。

调用 WdfDeviceWdmDispatchPreprocessedIrp

由于 I/O 管理器将其他 I/O 堆栈位置添加到 IRP， 因此 EvtDeviceWdmIrpPreprocess 回调函数必须调用 IoSkipCurrentIrpStackLocation 或 IoCopyCurrentIrpStackLocationToNext (，以在 IRP) 中设置下一个 I/O 堆栈位置，然后再调用 WdfDeviceWdmDispatchPreprocessedIrp。

如果驱动程序正在预处理 IRP，但未对 IRP 进行后处理，则驱动程序无需为 IRP 设置 IoCompletion 例程，并且可以调用 IoSkipCurrentIrpStackLocation，如以下代码示例所示。

NTSTATUS
  EvtDeviceMyIrpPreprocess(
    IN WDFDEVICE Device,
    IN OUT PIRP Irp
    )
{
//
// Perform IRP preprocessing operations here.
//
...
//
// Deliver the IRP back to the framework. 
//
IoSkipCurrentIrpStackLocation(Irp);
return WdfDeviceWdmDispatchPreprocessedIrp(Device, Irp);
}

 如果驱动程序正在对 IRP 进行后处理，则驱动程序必须调用 IoCopyCurrentIrpStackLocationToNext，然后它必须调用 IoSetCompletionRoutine 来为 IRP 设置 IoCompletion 例程，如以下代码示例所示。

NTSTATUS
  EvtDeviceMyIrpPreprocess(
    IN WDFDEVICE Device,
    IN OUT PIRP Irp
    )
{
//
// Perform IRP preprocessing operations here, if needed.
//
...
//
// Set a completion routine and deliver the IRP back to
// the framework. 
//
IoCopyCurrentIrpStackLocationToNext(Irp);
IoSetCompletionRoutine(
                       Irp,
                       MyIrpCompletionRoutine,
                       NULL,
                       TRUE,
                       TRUE,
                       TRUE
                      );
return WdfDeviceWdmDispatchPreprocessedIrp(Device, Irp);
}

 驱动程序不得调用 IoCopyCurrentIrpStackLocationToNext ，因此不得设置 IoCompletion 例程，如果驱动程序的 EvtDeviceWdmIrpPrepPreprocess 函数接收的设备对象表示 (PDO) 的物理设备对象，并且 IRP 的主要函数代码IRP_MJ_PNP或IRP_MJ_POWER。 否则， 驱动程序验证程序 将报告错误。

将 IRP 调度到 I/O 队列

基于框架的驱动程序可以动态指定传入 IRP 的目标队列。 若要将 IRP 调度到特定队列，驱动程序必须调用 WdfDeviceWdmDispatchIrpToIoQueue 方法。

通常，驱动程序从其 EvtDeviceWdmIrpPrepPreprocess 或 EvtDeviceWdmIrpDispatch 回调函数调用 WdfDeviceWdmDispatchIrpToIoQueue。 为了获得最佳性能，大多数驱动程序不提供这两个回调函数。

注意 UMDF 驱动程序可以提供 EvtDeviceWdmIrpDispatch 回调函数，但只有 KMDF 驱动程序可以提供 EvtDeviceWdmIrpPreprocess。

如果驱动程序已提供 EvtDeviceWdmIrpPrepPreprocess，则可以使用它来动态选择队列。 如果没有，请提供 EvtDeviceWdmIrpDispatch ，并从该回调函数中调用 WdfDeviceWdmDispatchIrpToIoQueue 。

此外，还应注意以下事项：

• 将 IRP 调度到 I/O 队列的另一种方法是 创建默认队列 ，然后从队列的处理程序中调用 WdfRequestForwardToIoQueue。 此方法从 KMDF 1.0 开始可用，但不适用于 前进进度队列 ，并且通常速度较慢。 请考虑改用 WdfDeviceWdmDispatchIrpToIoQueue；
• 调用 WdfDeviceConfigureWdmIrpDispatchCallback 以注册 EvtDeviceWdmIrpDispatch 回调函数时，驱动程序必须将 MajorFunction 参数设置为下列参数之一：IRP_MJ_DEVICE_CONTROL、IRP_MJ_INTERNAL_DEVICE_CONTROL、IRP_MJ_READ、IRP_MJ_WRITE。 虽然此要求不适用于 EvtDeviceWdmIrpPreprocess，但只能将这些类型的 IRP 动态调度到指定的队列；
• 转到 EvtDeviceWdmIrpPreprocess 的 IRP 具有额外的堆栈位置。 转到 EvtDeviceWdmIrpDispatch (且没有以前调用 EvtDeviceWdmIrpPreprocess) 的 IRP 不会；
• EvtDeviceWdmIrpPreprocess 不便于发送驱动程序定义的上下文信息，而 EvtDeviceWdmIrpDispatch 则有助于发送；

调度未预处理的 IRP

若要从驱动程序的 EvtDeviceWdmIrpDispatch 回调函数调度 IRP，请使用以下过程：

• 从其 EvtDriverDeviceAdd 回调函数中，驱动程序调用 WdfDeviceConfigureWdmIrpDispatchCallback 来注册 EvtDeviceWdmIrpDispatch 回调函数。如果目标是父设备的 I/O 队列，KMDF 驱动程序必须先调用 WdfPdoInitAllowForwardingRequestToParent ，然后才能调用 WdfDeviceCreate。 如果 KMDF 驱动程序还提供了 EvtDeviceWdmIrpPreprocess 回调函数，则框架会在 IRP 到达时首先调用该函数。 回调函数预处理请求后，它会调用 WdfDeviceWdmDispatchPreprocessedIrp 将 IRP 返回到框架；
• 框架调用驱动程序的 EvtDeviceWdmIrpDispatch 回调函数；
• 在 EvtDeviceWdmIrpDispatch 中，驱动程序可以调用 WdfDeviceWdmDispatchIrpToIoQueue 或 WdfDeviceWdmDispatchIrp，但不能同时调用两者。 KMDF 驱动程序具有其他选项，即不调用这两种方法，而是完成 IRP 或将其标记为挂起；
• 如果 KMDF 驱动程序已设置WDF_DISPATCH_IRP_TO_IO_QUEUE_INVOKE_INCALLERCTX_CALLBACK标志，并且尚未为目标 I/O 队列启用有保证的向前进度，则框架会调用驱动程序的 EvtIoInCallerContext（如果提供）。 预处理请求后，回调函数必须通过调用 WdfDeviceEnqueueRequest 将其排队，或通过调用 WdfRequestComplete 完成该请求；

调度预处理的 IRP

若要将驱动程序的 EvtDeviceWdmIrpPreprocess 回调函数中的 IRP 调度到特定的 I/O 队列，请使用以下过程：

• 驱动程序通过调用 WdfDeviceInitAssignWdmIrpPreprocessCallback 来注册 EvtDeviceWdmIrpPreprocess 回调函数；
• 如果目标是父设备的 I/O 队列，驱动程序将调用 WdfPdoInitAllowForwardingRequestToParent；
• 在 EvtDeviceWdmIrpPreprocess 中，调用 WdfDeviceWdmDispatchIrpToIoQueue ， 标志 设置为 WDF_DISPATCH_IRP_TO_IO_QUEUE_PREPROCESSED_IRP；
• 如果驱动程序已设置WDF_DISPATCH_IRP_TO_IO_QUEUE_INVOKE_INCALLERCTX_CALLBACK标志，并且尚未为目标 I/O 队列启用有保证的向前进度，则框架会调用驱动程序的 EvtIoInCallerContext（如果提供）。 回调函数完成对请求的预处理后，必须通过调用 WdfDeviceEnqueueRequest 将其 排队，或通过调用 WdfRequestComplete 完成该请求；

处理框架不支持的 IRP

框架不支持具有以下主要 IRP 代码的 I/O 请求：

IRP_MJ_CREATE_MAILSLOT
IRP_MJ_CREATE_NAMED_PIPE
IRP_MJ_DEVICE_CHANGE
IRP_MJ_DIRECTORY_CONTROL
IRP_MJ_FILE_SYSTEM_CONTROL
IRP_MJ_FLUSH_BUFFERS
IRP_MJ_LOCK_CONTROL
IRP_MJ_QUERY_EA
IRP_MJ_QUERY_INFORMATION
IRP_MJ_QUERY_QUOTA
IRP_MJ_QUERY_SECURITY
IRP_MJ_QUERY_VOLUME_INFORMATION
IRP_MJ_SET_EA
IRP_MJ_SET_INFORMATION
IRP_MJ_SET_QUOTA
IRP_MJ_SET_SECURITY
IRP_MJ_SET_VOLUME_INFORMATION

如果框架收到包含其中一个 I/O 函数代码的 IRP，则框架不会处理 IRP。 如果驱动程序是Filter驱动程序，框架会将 IRP 传递给驱动程序堆栈中下一个较低的驱动程序。 如果驱动程序不是Filter驱动程序，框架会调用 IoCompleteRequest 以完成状态值为 STATUS_INVALID_DEVICE_REQUEST 的 IRP。

如果驱动程序必须处理包含其中任何 I/O 函数代码的 IRP，则驱动程序必须调用 WdfDeviceInitAssignWdmIrpPreprocessCallback ，以便为 I/O 函数代码注册 EvtDeviceWdmIrpPreprocess 事件回调函数。

当驱动程序收到包含驱动程序为其注册 EvtDeviceWdmIrpPreprocess 回调函数的 I/O 函数代码的 IRP 时，框架会将 IRP 传递给回调函数。 然后，回调函数必须遵循 处理 IRP 的 WDM 规则来处理 IRP。 驱动程序必须调用 IoCompleteRequest 来完成 IRP，或者必须调用 IoCallDriver 才能将 IRP 传递给下一个较低的驱动程序。

获取 WDM 信息

框架提供了多种对象方法，使驱动程序能够获取 WDM 定义的信息。

获取有关驱动程序及其设备的 WDM 信息

若要获取有关驱动程序及其设备的 WDM 信息，驱动程序可以调用以下方法：

WdfFdoInitWdmGetPhysicalDevice：检索表示设备物理设备对象的 DEVICE_OBJECT 结构 (PDO) 。 驱动程序可以在驱动程序为设备创建框架设备对象之前调用此方法。

WdfDeviceWdmGetPhysicalDevice：检索表示设备 PDO 的 WDM DEVICE_OBJECT结构。 驱动程序可以在为设备创建框架设备对象后调用此方法。

WdfDeviceWdmGetDeviceObject：返回与指定的框架设备对象关联的 WDM 设备对象。

WdfDeviceWdmGetAttachedDevice：返回 设备堆栈中下一个较低的 WDM 设备对象。

WdfWdmDeviceGetWdfDeviceHandle：返回与指定的 WDM 设备对象关联的框架设备对象的句柄。

WdfWdmDriverGetWdfDriverHandle：返回与指定的 WDM 驱动程序对象关联的框架驱动程序对象的句柄。

获取有关 I/O 请求的 WDM 信息

若要获取有关 I/O 请求的 WDM 信息，驱动程序可以调用以下方法：

WdfRequestWdmGetIrp：返回与指定的框架请求对象关联的 WDM IRP 结构；另一方面，在框架外部接收 WDM IRP 的驱动程序可以通过调用 WdfRequestCreateFromIrp。

WdfRequestGetParameters：检索与指定的框架请求对象关联的参数。 其中大多数参数来自请求的 WDM I/O 堆栈位置。

WdfRequestRetrieveOutputWdmMdl：表示 I/O 请求的输出缓冲区的 MDL检索内存描述符列表。

WdfRequestRetrieveInputWdmMdl：检索表示 I/O 请求输入缓冲区的 MDL。

WdfRequestFormatRequestUsingCurrentType：将调用驱动程序的 I/O 堆栈位置的内容复制到驱动程序的本地 I/O 目标的 I/O 堆栈位置。

WdfRequestWdmFormatUsingStackLocation：为驱动程序的本地 I/O 目标设置 I/O 堆栈位置的内容。

获取有关 I/O 目标的 WDM 信息

若要获取有关 I/O 目标的 WDM 信息，驱动程序可以调用以下方法：

WdfIoTargetWdmGetTargetDeviceObject：返回指向与本地或远程 I/O 目标关联的 WDM 设备对象的指针。

WdfIoTargetWdmGetTargetFileObject：返回指向与远程 I/O 目标关联的 WDM FILE_OBJECT 结构的指针。

WdfIoTargetWdmGetTargetFileHandle：返回与远程 I/O 目标关联的文件的句柄。

WdfIoTargetWdmGetTargetPhysicalDevice：返回指向 WDM 物理设备对象的指针， 表示远程 I/O 目标设备的 PDO。

获取有关中断和 DPC 的 WDM 信息

若要获取有关中断和延迟过程调用 (DPC) 的 WDM 信息，驱动程序可以调用以下方法：

WdfInterruptWdmGetInterrupt：返回指向与指定框架中断对象关联的 WDM KINTERRUPT 结构的指针。

WdfDpcWdmGetDpc：返回指向与指定框架 DPC 对象关联的 WDM KDPC 结构的指针。

获取有关 USB I/O 目标的 WDM 信息

若要获取有关 USB I/O 目标的 WDM 信息，驱动程序可以调用以下方法：

WdfUsbTargetPipeWdmGetPipeHandle：返回与指定的框架管道对象关联的USBD_PIPE_HANDLE类型句柄。

获取有关注册表的 WDM 信息

若要获取有关注册表的 WDM 信息，驱动程序可以调用以下方法：

WdfRegistryWdmGetHandle：返回框架注册表项对象表示的注册表项的 WDM 句柄。

获取有关文件对象的 WDM 信息

若要获取有关文件对象的 WDM 信息，驱动程序可以调用以下方法：

WdfFileObjectWdmGetFileObject：返回与指定的框架文件对象关联的 WDM FILE_OBJECT 结构。