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 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	<= APC_LEVEL

こちらもご覧ください

EX_RUNDOWN_REF

ExInitializeRundownProtection