ExAcquireRundownProtectionEx 函式 (wdm.h)

ExAcquireRundownProtectionEx 例程會嘗試取得共享物件上的執行保護，讓呼叫端可以安全地存取物件。

語法

BOOLEAN ExAcquireRundownProtectionEx(
  [in, out] PEX_RUNDOWN_REF RunRef,
  [in]      ULONG           Count
);

參數

[in, out] RunRef

先前呼叫 ExInitializeRundownProtection 例程所初始化之EX_RUNDOWN_REF結構的指標。 執行保護例程會使用此結構來追蹤相關聯共用對象的執行狀態。 此結構對驅動程式不透明。

[in] Count

要遞增至 物件執行實例計數的量。 只有在例程傳回 TRUE 時，才會遞增計數。 如需詳細資訊，請參閱備註

傳回值

如果例程成功取得呼叫端的執行保護，ExAcquireRundownProtectionEx 會傳回 TRUE。 否則會傳回 FALSE。 FALSE 的傳回值表示對象的執行已啟動，而且對象必須視為無效。

備註

為了安全地存取共用對象，驅動程式會呼叫 ExAcquireRundownProtectionEx ，以取得物件的下拉式保護。

RunRef 參數指向追蹤相關聯物件執行狀態的EX_RUNDOWN_REF結構。 此狀態資訊包含目前對物件生效之執行保護實例的計數。 ExAcquireRundownProtectionEx 和 ExReleaseRundownProtectionEx 例程會依任意數量遞增和遞減此計數。 兩個相關的例程 ExAcquireRundownProtection 和 ExReleaseRundownProtection，遞增並遞減此計數。

只要 run-down 區塊本身為非分頁，就可以在 DISPATCH_LEVEL呼叫此函式。

如需詳細資訊，請參閱 Run-Down Protection。

規格需求

另請參閱

EX_RUNDOWN_REF

ExAcquireRundownProtection

ExInitializeRundownProtection

ExReleaseRundownProtection

ExReleaseRundownProtectionEx