Fungsi ExAcquireFastMutexUnsafe (wdm.h)

Artikel
02/27/2024

Rutinitas ExAcquireFastMutexUnsafe memperoleh mutex cepat yang ditentukan untuk utas panggilan.

Sintaks

void ExAcquireFastMutexUnsafe(
  PFAST_MUTEX FastMutex
);

Parameter

FastMutex

[in, out] Struktur penunjuk ke FAST_MUTEX) tempat pemanggil menyediakan penyimpanan. Pemanggil sebelumnya menginisialisasi struktur ini dengan panggilan ke rutinitas ExInitializeFastMutex

Nilai kembali

Tidak ada

Keterangan

ExAcquireFastMutexUnsafe menempatkan pemanggil ke dalam status tunggu jika mutex cepat yang ditentukan tidak dapat segera diperoleh. Jika tidak, pemanggil diberikan kepemilikan mutex dan akses eksklusif ke sumber daya yang dilindungi mutex hingga pemanggil melepaskan mutex.

Setiap mutex cepat yang diperoleh oleh panggilan ke ExAcquireFastMutexUnsafe harus dirilis dengan panggilan ke rutinitas ExReleaseFastMutexUnsafe .

Rutinitas ExAcquireFastMutex dan ExAcquireFastMutexUnsafe menyebabkan utas panggilan diblokir hingga mutex tersedia. Rutinitas ExTryToAcquireFastMutex segera kembali dengan nilai pengembalian FALSE jika utas lain telah memperoleh mutex. ExAcquireFastMutex dan ExTryToAcquireFastMutex meningkatkan IRQL ke APC_LEVEL sebelum memperoleh mutex cepat. Driver harus menggunakan ExAcquireFastMutexUnsafe, yang tidak menaikkan IRQL, hanya jika salah satu hal berikut ini benar:

Utas sudah berjalan di APC_LEVEL.
Utas memperoleh mutex dalam wilayah kritis yang sebelumnya dimasukkan oleh panggilan ke rutinitas KeEnterCriticalRegion atau FsRtlEnterFileSystem .

Untuk informasi selengkapnya tentang mutex cepat, lihat topik berikut:

Mutex Cepat dan Mutex Yang Dijaga

Kunci, Kebuntuan, dan Sinkronisasi