ExInitializeRundownProtection ルーチンは、共有オブジェクトのランダウン保護を初期化します。
構文
void ExInitializeRundownProtection(
[out] PEX_RUNDOWN_REF RunRef
);
パラメーター
[out] RunRef
初期化する呼び出し元によって割り当てられた EX_RUNDOWN_REF 構造体へのポインター。 割り当ては、32 ビット プラットフォームでは 4 バイトでアラインされ、8 バイトは 64 ビット プラットフォームでアラインされている必要があります。 詳細については、「解説」を参照してください。
戻り値
何一つ
備考
このルーチンは、共有メモリ内に存在し、他のドライバーがアクセスするオブジェクトを所有するドライバーによって呼び出されます。
ExInitializeRundownProtection 呼び出して EX_RUNDOWN_REF 構造体を初期化してから、他のランダウン保護ルーチンにパラメーターとして渡す必要があります。
ランダウン保護ルーチンは、EX_RUNDOWN_REF 構造体を使用して、構造体に関連付けられている共有オブジェクトの実行状態を追跡します。 この状態情報には、現在オブジェクトに対して有効になっているランダウン保護のインスタンスの数が含まれます。 ExInitializeRundownProtection 、このカウントを 0 に初期化します。
EX_RUNDOWN_REF 構造体が初期化されると、関連付けられているオブジェクトにアクセスする他のドライバーは、ExAcquireRundownProtection を呼び出し、ExReleaseRundownProtection ルーチンを して、オブジェクトのランダウン保護を取得および解放できます。
詳細については、「Run-Down 保護」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP 以降で使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | wdm.h (Wdm.h を含む) |
| ライブラリ | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
関連項目
ExAcquireRundownProtection の
ExReleaseRundownProtection の