Fungsi ExAcquireRundownProtectionEx (wdm.h)

  • Artikel

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

Sintaks

BOOLEAN ExAcquireRundownProtectionEx(
  [in, out] PEX_RUNDOWN_REF RunRef,
  [in]      ULONG           Count
);

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.

[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

ExAcquireRundownProtectionEx 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 ExAcquireRundownProtectionEx untuk memperoleh perlindungan run-down pada objek.

Parameter RunRef menunjuk ke struktur EX_RUNDOWN_REF yang melacak status run-down objek terkait. Informasi status ini mencakup hitungan instans perlindungan run-down yang saat ini berlaku pada objek . Rutinitas ExAcquireRundownProtectionEx dan ExReleaseRundownProtectionEx mengalami kenaikan dan penurunan jumlah ini dengan jumlah arbitrer. Dua rutinitas terkait, ExAcquireRundownProtection dan ExReleaseRundownProtection, 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.

Persyaratan

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

Lihat juga

EX_RUNDOWN_REF

ExAcquireRundownProtection

ExInitializeRundownProtection

ExReleaseRundownProtection

ExReleaseRundownProtectionEx