exRundownCompleted 函式 (wdm.h)

ExRundownCompleted 例程會更新共享對象的執行狀態，以指出對象的執行已完成。

語法

void ExRundownCompleted(
  [out] PEX_RUNDOWN_REF RunRef
);

參數

[out] RunRef

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

傳回值

無

備註

此例程是由擁有位於共用記憶體中且由其他驅動程式存取之對象的驅動程式所呼叫。 ExRundownCompleted 呼叫之前必須呼叫執行物件的 ExWaitForRundownProtectionRelease 例程。

在 ExRundownCompleted 呼叫之後，對 ExWaitForRundownProtectionRelease 的其他呼叫會立即執行相關聯的對象傳回，而不需等候。 不過，呼叫 ExAcquireRundownProtection 以取得相關聯物件的下拉式保護失敗， (傳回 FALSE) 。

在 ExRundownCompleted 呼叫之後，驅動程式可以呼叫 ExReInitializeRundownProtection 例程，將EX_RUNDOWN_REF結構與新對象產生關聯，並初始化此物件的向下執行保護。 在 ExReInitializeRundownProtection 呼叫之後，驅動程式可以呼叫 ExAcquireRundownProtection，以取得新物件的下拉式保護。

在專案上， EX_RUNDOWN_REF 結構中的狀態信息必須指出與此結構相關聯的物件已執行。

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

規格需求

需求	值
最低支援的用戶端	從 Windows XP 開始提供。
目標平台	Universal
標頭	wdm.h (包含 Wdm.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<= APC_LEVEL

另請參閱

EX_RUNDOWN_REF

ExInitializeRundownProtection