ExInitializeRundownProtection 函数 (wdm.h)

ExInitializeRundownProtection 例程初始化共享对象的运行保护。

语法

void ExInitializeRundownProtection(
  [out] PEX_RUNDOWN_REF RunRef
);

参数

[out] RunRef

指向要初始化的调用方分配 EX_RUNDOWN_REF 结构的指针。 分配必须在 32 位平台上对齐 4 字节,在 64 位平台上对齐 8 字节。 有关详细信息,请参阅“备注”。

返回值

备注

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

必须先调用 ExInitializeRundownProtection 来初始化EX_RUNDOWN_REF结构,然后才能将其作为参数传递给任何其他运行保护例程。

运行保护例程使用 EX_RUNDOWN_REF 结构来跟踪与结构关联的共享对象的运行状态。 此状态信息包括当前对对象的已运行保护实例计数。 ExInitializeRundownProtection 将此计数初始化为零。

初始化 EX_RUNDOWN_REF 结构后,访问关联对象的其他驱动程序可以调用 ExAcquireRundownProtectionExReleaseRundownProtection 例程来获取并释放对对象的运行保护。

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

要求

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

另请参阅

EX_RUNDOWN_REF

ExAcquireRundownProtection

ExReleaseRundownProtection