exRundownCompleted 函数 (wdm.h)
ExRundownCompleted 例程更新共享对象的运行状态,以指示对象的运行已完成。
语法
void ExRundownCompleted(
[out] PEX_RUNDOWN_REF RunRef
);
参数
[out] RunRef
指向 EX_RUNDOWN_REF 结构的指针,该结构由先前对 ExInitializeRundownProtection 例程的调用初始化。 运行保护例程使用此结构来跟踪关联的共享对象的运行状态。 此结构对驱动程序不透明。
返回值
无
备注
此例程由驱动程序调用,该驱动程序拥有位于共享内存中并由其他驱动程序访问的对象。 在 ExRundownCompleted 调用之前,必须调用运行对象的 ExWaitForRundownProtectionRelease 例程。
在 ExRundownCompleted 调用后,对 ExWaitForRundownProtectionRelease 的其他调用将立即返回运行关联的对象,而无需等待。 但是,调用 ExAcquireRundownProtection 来获取关联对象的运行保护失败, (返回 FALSE) 。
在 ExRundownCompleted 调用后,驱动程序可以调用 ExReInitializeRundownProtection 例程,以将 EX_RUNDOWN_REF 结构与新对象相关联,并初始化此对象的运行保护。 在 ExReInitializeRundownProtection 调用后,驱动程序可以调用 ExAcquireRundownProtection 来获取对新对象的运行保护。
输入时, EX_RUNDOWN_REF 结构中的状态信息必须指示与此结构关联的对象已运行。
有关详细信息,请参阅 Run-Down Protection。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 从 Windows XP 开始可用。 |
目标平台 | 通用 |
标头 | wdm.h (包括 Wdm.h) |
Library | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |