ExReInitializeRundownProtection 函数 (wdm.h)

项目
03/05/2024

ExReInitializeRundownProtection 例程在关联对象运行后重新初始化EX_RUNDOWN_REF结构。

语法

void ExReInitializeRundownProtection(
  [in, out] PEX_RUNDOWN_REF RunRef
);

参数

[in, out] RunRef

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

返回值

无

备注

此例程由驱动程序调用，该驱动程序拥有位于共享内存中并由其他驱动程序访问的对象。

ExReInitializeRundownProtection 使以前使用的 EX_RUNDOWN_REF 结构能够与新对象相关联，并初始化此对象的运行保护。在 ExReInitializeRundownProtection 调用后，驱动程序可以调用 ExAcquireRundownProtection 来获取对新对象的运行保护。

ExReInitializeRundownProtection 调用之前，必须调用运行旧对象的 ExWaitForRundownProtectionRelease 例程。在 ExWaitForRundownProtectionRelease 和 ExReInitializeRundownProtection 调用之间，驱动程序可能会调用 ExRundownCompleted 例程，以指示旧对象的运行已完成。

输入时， EX_RUNDOWN_REF 结构中的状态信息必须指示旧对象已运行。

有关详细信息，请参阅 Run-Down Protection。

要求

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