ExRundownCompleted 函式 (wdm.h)
ExRundownCompleted 例程會更新共用物件的執行狀態,以指出對象的執行已完成。
語法
void ExRundownCompleted(
[out] PEX_RUNDOWN_REF RunRef
);
參數
[out] RunRef
先前呼叫 exInitializeRundownProtection 例程所初始化之EX_RUNDOWN_REF 結構的指標。 Run-down 保護例程會使用此結構來追蹤相關聯共用物件的執行狀態。 此結構對驅動程式不透明。
傳回值
沒有
言論
此例程是由擁有位於共用記憶體中且由其他驅動程式存取之對象的驅動程式所呼叫。 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 |