IoCompleteRequest routine

最新推荐文章于 2024-08-15 22:19:47 发布

翻译最新推荐文章于 2024-08-15 22:19:47 发布 · 1.3k 阅读

WDK翻译专栏收录该内容

55 篇文章

订阅专栏

本文详细介绍了IoCompleteRequest例程在Windows驱动程序中的使用方法及注意事项，包括参数解释、返回值、相关要求和DDI合规性规则等关键信息。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

IoCompleteRequest routine

调用 IoCompleteRequest 例程表示调用者已经处理完一个给定的I/O请求，并将指定的IRP返回给I/O manager.

Syntax

VOID IoCompleteRequest(
  _In_ PIRP  Irp,
  _In_ CCHAR PriorityBoost
);

Parameters

Irp [in]

指向将完成的IRP。

PriorityBoost [in]

指定一个系统定义的常量，此常量用以提升请求该操作的线程的运行时优先级。若线程请求的操作是一个可以迅速完成的操作(so the requesting thread is not compensated for its assumed wait for I/O to be completed) ,或者是IRP以一个错误结束，这个值设置为IO_NO_INCREMENT。否则这个PriorityBoost常量是设备类型相关的值，关于这些常量见Ntddk.h or Wdm.h

Return value

None

Remarks

当驱动程序完成了对一个给定IRP的所有处理过程时调用IoCompleteRequest。I/O manager检查确认是否有一个更高层级的驱动程序在这个IRP设置了IoCompletion 例程，如果则依次调用每一个IoCompletion ，直到所有层上的驱动程序都完成了IRP。

When all drivers have completed a given IRP, the I/O manager returns status to the original requester of the operation. Note that a higher-level driver that sets up a driver-created IRP must supply an IoCompletion routine to release the IRP it created.

Never call IoCompleteRequest while holding a spin lock. Attempting to complete an IRP while holding a spin lock can cause deadlocks.当所有的驱动程序都完成了给定的IRP。I/O manager返回状态值给最初的操作请求者。注意一个创建了一个“驱动创建”的IRP的高层级的驱动程序必须提供一个IoCompletion 以释放它创建的IRP。请勿在获得一个 spin lock时调用IoCompleteRequest 。在获得一个spin lock 时试图完成一个IRP将可能导致死锁。

Requirements

Target platform	Universal
Version	Available starting with Windows 2000.
Header	Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
DDI compliance rules	CompleteRequest, CompleteRequestStatusCheck, DoubleCompletion, IoAllocateComplete, IoBuildFsdComplete,IoSetCompletionExCompleteIrp, IrpProcessingComplete, MarkIrpPending, PendedCompletedRequest,PendedCompletedRequest2, PendedCompletedRequest3, PendedCompletedRequestEx, PnpIrpCompletion, SpinLockSafe,WmiComplete, HwStorPortProhibitedDDIs, SpinLockSafe(storport)