函数原型

参数

返回值

头文件

PS

IoCompleteRequest 例程表示调用者的已经完成了对指定I/O请求的所有处理操作，并且向I/O管理器返回指定的IRP报文。

函数原型

VOID

IoCompleteRequest(

IN PIRP Irp,

IN CCHAR PriorityBoost

);

参数

Irp 指向将要完成的IRP报文数据结构。 PriorityBoost 指定系统定义的常量，用来增加运行时要求操作的原始线程的优先权。如果要求操作的原始线程需要驱动程序快速的完成处理，或者IRP填充完成时有错误发生，那么这个值就应该设为 IO_NO_INCREMENT。否则PriorityBoost 常量的值应设为device-type-specific常量。具体取哪些常量可以参见 ntddk.h 或 wdm.h 文件。

返回值

无

头文件

在 wdm.h 和 ntddk.h 中被定义。需要包含 wdm.h 或 ntddk.h 文件。

注释当驱动完成了对指定IRP的所有处理操作之后，会调用 IoCompleteRequest 。I/O管理器检查IRP以决定上级驱动是否已经为这个IRP指定了一个 IoCompletion 例程。如果这样的话，每一个 IoCompletion 例程将会依次被调用，直到在驱动链中的每一个分层驱动已经完成这个IRP的填充操作为止。

当所有的驱动已充填充完了指定的IRP时，I/O管理器会向操作的原始请求者返回一个状态值。需要注意的是，一个设置了 driver-created 的IRP的上级驱动必须提供一个 IoCompletion 例程来释放它当初创建的那个IRP。

在一个自旋锁被占用时，不要调用IoCompleteRequest 。当一个自旋锁被占用时，试图完成一个IRP的填充操作会导致死锁。

IoCompleteRequest 的调用者必须是运行在 IRQL <= DISPATCH_LEVEL 上的。

PS

这个函数一般出现在I/O Dispatch系列函数中。当用户层与内核层设备进行通讯时，比如用户层调用了CreateFile、CloseHandle、ReadFile、WriteFile和DeviceIoControl等I/O操作函数时，内核会调用代码中已经指派的DRIVER_DISPATCH系列函数。如果用户层的这些函数是采用同步方式(Synchronous)调用的话，那么只有当内核DRIVER_DISPATCH函数中调用了IoCompleteRequest(Irp, IO_NO_INCREMENT);之后，用户层的函数才会返回。