ExRundownCompleted 函数 (wdm.h)

ExRundownCompleted 例程更新共享对象的运行状态,以指示对象的运行已完成。

语法

void ExRundownCompleted(
  [out] PEX_RUNDOWN_REF RunRef
);

参数

[out] RunRef

指向先前调用 ExInitializeRundownProtection 例程初始化的 EX_RUNDOWN_REF 结构的指针。 运行保护例程使用此结构来跟踪关联的共享对象的运行状态。 此结构对驱动程序不透明。

返回值

没有

言论

此例程由拥有驻留在共享内存中的对象且由其他驱动程序访问的驱动程序调用。 ExRundownCompleted 调用之前,必须先调用运行对象的 ExWaitForRundownProtectionRelease 例程。

ExRundownCompleted 调用后,对 ExWaitForRundownProtectionRelease 调用以立即运行关联的对象返回,而无需等待。 但是,调用 ExAcquireRundownProtection 获取关联对象的运行保护失败(返回 FALSE)。

ExRundownCompleted 调用后,驱动程序可以调用 ExReInitializeRundownProtection 例程,将 EX_RUNDOWN_REF 结构与新对象相关联,并初始化此对象的运行保护。 ExReInitializeRundownProtection 调用后,驱动程序可以调用 ExAcquireRundownProtection 以获取新对象的运行保护。

在条目中,EX_RUNDOWN_REF 结构中的状态信息必须指示与此结构关联的对象已运行。

有关详细信息,请参阅 Run-Down 保护

要求

要求 价值
最低支持的客户端 从 Windows XP 开始可用。
目标平台 普遍
标头 wdm.h (包括 Wdm.h)
NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

另请参阅

EX_RUNDOWN_REF

ExInitializeRundownProtection