ExAcquireRundownProtectionCacheAwareEx 関数 (wdm.h)

[アーティクル]
02/27/2024

ExAcquireRundownProtectionCacheAwareEx ルーチンは、呼び出し元がオブジェクトに安全にアクセスできるように、共有オブジェクトに対するキャッシュ対応のランダウン保護を取得しようとします。

構文

BOOLEAN ExAcquireRundownProtectionCacheAwareEx(
  [in, out] PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware,
  [in]      ULONG                       Count
);

パラメーター

[in, out] RunRefCacheAware

ExAllocateCacheAwareRundownProtection または ExInitializeRundownProtectionCacheAware の以前の呼び出しによって返された不透明なEX_RUNDOWN_REF_CACHE_AWARE構造体へのポインター。

[in] Count

オブジェクトのランダウンインスタンス数まで増分する量。カウントは、ルーチンが TRUE を返す場合にのみインクリメントされます。詳細については、「解説」を参照してください。

戻り値

ExAcquireRundownProtectionCacheAwareEx は、ルーチンが呼び出し元のランダウン保護を正常に取得した場合に TRUE を 返します。それ以外の場合は、 FALSE を返します。 FALSE の戻り値は、オブジェクトの実行が開始され、オブジェクトが無効として扱われる必要があることを示します。

注釈

RunRefCacheAware パラメーターは、関連付けられたオブジェクトのランダウン状態を追跡するEX_RUNDOWN_REF_CACHE_AWARE構造体を指します。この状態情報には、現在オブジェクトに対して有効になっているキャッシュ対応のランダウン保護のインスタンスの数が含まれます。 ExAcquireRundownProtectionCacheAwareEx ルーチンと ExReleaseRundownProtectionCacheAwareEx ルーチンは、この数を任意の量だけインクリメントおよびデクリメントします。 ExAcquireRundownProtectionCacheAware と ExReleaseRundownProtectionCacheAware の 2 つの関連ルーチンで、この数を 1 ずつインクリメントおよびデクリメントします。

ランダウンブロック自体が非ページである限り、この関数は DISPATCH_LEVEL で呼び出すことができます。

詳細については、「キャッシュ対応のランダウン保護」を参照してください。

要件

要件	値
サポートされている最小のサーバー	Windows Server 2003 Service Pack 1
Header	wdm.h (Wdm.h を含む)
DDI コンプライアンス規則	HwStorPortProhibitedDDIs(storport)