ExInitializeRundownProtectionCacheAware 函式 (wdm.h)

發行項
02/27/2024

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

語法

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

參數

[out] RunRefCacheAware

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

[in] RunRefSize

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

傳回值

無

備註

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

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

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

EX_RUNDOWN_REF_CACHE_AWARE 結構是用來管理取消保護的不透明結構。呼叫端應該先呼叫 ExSizeOfRundownProtectionCacheAware ，以判斷取消保護對象的適當大小。然後，應該使用此大小來配置 RunRefCacheAware 參數的緩衝區，並傳遞為 RunRefSize 參數。