ExInitializeRundownProtectionCacheAware 函式（wdm.h）

發行項
02/07/2025

此例程會初始化快取感知的取消保護物件。

語法

void ExInitializeRundownProtectionCacheAware(
  [out] PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware,
  [in]  SIZE_T                      RunRefSize
);

參數

[out] RunRefCacheAware

呼叫端提供的緩衝區指標，其中例程會傳回不透明的 EX_RUNDOWN_REF_CACHE_AWARE 結構。如需詳細資訊，請參閱。

[in] RunRefSize

指定取消保護物件的大小，以位元組為單位。

傳回值

沒有

言論

Rundown 保護是 Windows 核心用來安全地清除多個線程可能存取之資源的同步處理機制。

此函式已針對受保護資源的存取模式具有快取感知的案例進行優化，這表示相同線程可能會重複存取資源，而且不同的線程可能會存取資源的不同部分。藉由使用此函式而非 ExInitializeRundownProtection，驅動程式可以降低快取爭用的可能性，其中多個線程爭用相同的快取行，導致效能降低。

此函式通常會在驅動程式的初始化階段使用，當它設定它需要運作的資源時。驅動程式會針對需要受快取感知的取消保護來保護的每個資源呼叫此函式。

EX_RUNDOWN_REF_CACHE_AWARE 結構是一種不透明的結構，可用來管理取消保護。呼叫端應該先呼叫 ExSizeOfRundownProtectionCacheAware，以判斷 rundown 保護物件的適當大小。然後，這個大小應該用來配置 RunRefCacheAware 參數的緩衝區，並傳遞為 RunRefSize 參數。