Fungsi ExAcquireRundownProtectionCacheAwareEx (wdm.h)

Artikel
02/27/2024

Rutinitas ExAcquireRundownProtectionCacheAwareEx mencoba memperoleh perlindungan run-down yang sadar cache pada objek bersama sehingga penelepon dapat mengakses objek dengan aman.

Sintaks

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

Parameter

[in, out] RunRefCacheAware

Penunjuk ke struktur EX_RUNDOWN_REF_CACHE_AWARE buram yang dikembalikan oleh panggilan sebelumnya ke ExAllocateCacheAwareRundownProtection atau ExInitializeRundownProtectionCacheAware.

[in] Count

Jumlah yang akan bertambah ke jumlah instans run-down objek. Jumlahnya bertambah hanya jika rutin mengembalikan TRUE. Untuk informasi selengkapnya, lihat Keterangan.

Mengembalikan nilai

ExAcquireRundownProtectionCacheAwareEx mengembalikan TRUE jika rutinitas berhasil memperoleh perlindungan run-down untuk pemanggil. Jika tidak, ia mengembalikan FALSE. Nilai pengembalian FALSE menunjukkan bahwa eksekusi ke bawah objek telah dimulai dan bahwa objek harus diperlakukan sebagai tidak valid.

Keterangan

Parameter RunRefCacheAware menunjuk ke struktur EX_RUNDOWN_REF_CACHE_AWARE yang melacak status run-down objek terkait. Informasi status ini mencakup jumlah instans perlindungan run-down yang sadar cache yang saat ini berlaku pada objek . Rutinitas ExAcquireRundownProtectionCacheAwareEx dan ExReleaseRundownProtectionCacheAwareEx meningkatkan dan mengurangi jumlah ini berdasarkan jumlah arbitrer. Dua rutinitas terkait, ExAcquireRundownProtectionCacheAware dan ExReleaseRundownProtectionCacheAware, kenaikan dan penurunan hitungan ini satu per satu.

Selama blok run-down itu sendiri tidak bertumpuk, fungsi ini dapat dipanggil pada DISPATCH_LEVEL.

Untuk informasi selengkapnya, lihat Perlindungan run-down yang sadar cache.

Persyaratan

Persyaratan	Nilai
Server minimum yang didukung	Windows Server 2003, Paket Layanan 1
Header	wdm.h (termasuk Wdm.h)
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport)