ExAcquireRundownProtectionEx 函式 (wdm.h)
ExAcquireRundownProtectionEx 例程會嘗試取得共享物件上的執行保護,讓呼叫者可以安全地存取物件。
語法
BOOLEAN ExAcquireRundownProtectionEx(
[in, out] PEX_RUNDOWN_REF RunRef,
[in] ULONG Count
);
參數
[in, out] RunRef
先前呼叫 exInitializeRundownProtection 例程所初始化之EX_RUNDOWN_REF 結構的指標。 Run-down 保護例程會使用此結構來追蹤相關聯共用物件的執行狀態。 此結構對驅動程式不透明。
[in] Count
要遞增至物件的向下執行實例計數的數量。 只有當例程傳回 true 時,才會遞增計數。 如需詳細資訊,請參閱。
傳回值
ExAcquireRundownProtectionEx 傳回 true true,如果例程成功取得呼叫者的執行保護。 否則,它會 FALSE傳回 。 FALSE 的傳回值 表示對象的執行已啟動,而且對象必須視為無效。
言論
為了安全地存取共用對象,驅動程式會呼叫 ExAcquireRundownProtectionEx,以取得對象的執行保護。
RunRef 參數指向追蹤相關聯物件執行狀態的 EX_RUNDOWN_REF 結構。 此狀態資訊包含目前在物件上生效之 Run-down 保護實例的計數。 ExAcquireRundownProtectionEx 和 ExReleaseRundownProtectionEx 例程會依任意數量遞增和遞減此計數。 兩個相關的例程,ExAcquireRundownProtection 和 ExReleaseRundownProtection,遞增和遞減此計數。
只要 run-down 區塊本身為非分頁,就可以在 DISPATCH_LEVEL呼叫此函式。
如需詳細資訊,請參閱 Run-Down 保護。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows Server 2003 開始提供。 |
目標平臺 | 普遍 |
標頭 | wdm.h (包括 Wdm.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL (請參閱備註) |
DDI 合規性規則 | HwStorPortProhibitedDIs(storport) |