Fungsi ExInitializeRundownProtectionCacheAware (wdm.h)

Artikel
02/27/2024

Rutinitas ini menginisialisasi objek perlindungan rundown yang sadar cache.

Sintaks

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

Parameter

[out] RunRefCacheAware

Penunjuk ke buffer yang disediakan penelepon di mana rutinitas mengembalikan struktur EX_RUNDOWN_REF_CACHE_AWARE buram. Lihat Keterangan untuk informasi selengkapnya.

[in] RunRefSize

Menentukan ukuran, dalam byte, dari objek perlindungan rundown.

Nilai kembali

Tidak ada

Keterangan

Perlindungan rundown adalah mekanisme sinkronisasi yang digunakan oleh kernel Windows untuk membersihkan sumber daya dengan aman yang mungkin diakses oleh beberapa utas.

Fungsi ini dioptimalkan untuk skenario di mana pola akses ke sumber daya yang dilindungi sadar cache, yang berarti bahwa utas yang sama kemungkinan akan mengakses sumber daya berulang kali, dan utas yang berbeda kemungkinan akan mengakses berbagai bagian sumber daya. Dengan menggunakan fungsi ini daripada ExInitializeRundownProtection, driver dapat mengurangi kemungkinan ketidakcocokan cache, di mana beberapa utas bersaing untuk baris cache yang sama, yang menyebabkan penurunan performa.

Fungsi ini biasanya digunakan selama fase inisialisasi driver, ketika menyiapkan sumber daya yang perlu dioperasikan. Driver memanggil fungsi ini untuk setiap sumber daya yang perlu dilindungi oleh perlindungan rundown yang sadar cache.

Struktur EX_RUNDOWN_REF_CACHE_AWARE adalah struktur buram yang digunakan untuk mengelola perlindungan rundown. Pemanggil harus terlebih dahulu memanggil ExSizeOfRundownProtectionCacheAware untuk menentukan ukuran yang sesuai untuk objek perlindungan rundown. Ukuran ini kemudian harus digunakan untuk mengalokasikan buffer untuk parameter RunRefCacheAware dan juga diteruskan sebagai parameter RunRefSize .