Fungsi ExAcquireRundownProtection (wdm.h)

  • Artikel

Rutinitas ExAcquireRundownProtection mencoba memperoleh perlindungan run-down pada objek bersama sehingga pemanggil dapat mengakses objek dengan aman.

Sintaks

BOOLEAN ExAcquireRundownProtection(
  [in, out] PEX_RUNDOWN_REF RunRef
);

Parameter

[in, out] RunRef

Penunjuk ke struktur EX_RUNDOWN_REF yang diinisialisasi oleh panggilan sebelumnya ke rutinitas ExInitializeRundownProtection . Rutinitas perlindungan run-down menggunakan struktur ini untuk melacak status run-down objek bersama terkait. Struktur ini buram untuk driver.

Mengembalikan nilai

ExAcquireRundownProtection 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

Untuk mengakses objek bersama dengan aman, driver memanggil ExAcquireRundownProtection untuk memperoleh perlindungan run-down pada objek. Rutinitas mengembalikan TRUE untuk menunjukkan bahwa perlindungan run-down berlaku. Ketika perlindungan run-down berlaku, driver dapat dengan aman mengakses objek tanpa risiko objek akan dihapus sebelum akses selesai.

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

Setelah menyelesaikan akses, driver memanggil ExReleaseRundownProtection untuk merilis perlindungan run-down yang diperoleh sebelumnya.

Jika ExAcquireRundownProtection mengembalikan FALSE, objek tidak lagi dapat diakses. Misalnya, jika objek akan diganti dengan yang baru, pemanggil harus menunggu pemilik objek membuat objek baru, lalu menegosiasikan akses ke objek baru.

Untuk informasi selengkapnya, lihat Perlindungan Run-Down.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows XP.
Target Platform Universal
Header wdm.h (termasuk Wdm.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL (lihat Keterangan)
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport)

Lihat juga

EX_RUNDOWN_REF

ExInitializeRundownProtection

ExReleaseRundownProtection