IoCompleteRequest例程表示调用者的已经完成了对指定I/O请求的所有处理操作,并且向I/O管理器返回指定的IRP报文。
函数原型VOID
IoCompleteRequest(
IN PIRPIrp,
IN CCHARPriorityBoost
);
参数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);之后,用户层的函数才会返回。