Fungsi ExReleaseFastMutex (wdm.h)

Artikel
02/27/2024

RutinItas ExReleaseFastMutex merilis kepemilikan mutex cepat yang diperoleh dengan ExAcquireFastMutex atau ExTryToAcquireFastMutex.

Sintaks

void ExReleaseFastMutex(
  PFAST_MUTEX FastMutex
);

Parameter

FastMutex

[in, out] Penunjuk ke mutex cepat untuk dilepaskan.

Nilai kembali

Tidak ada

Keterangan

ExReleaseFastMutex merilis kepemilikan mutex cepat yang diberikan dan menetapkan IRQL ke nilai yang dijalankan pemanggil sebelum disebut ExAcquireFastMutex. Jika IRQL sebelumnya kurang dari APC_LEVEL, pengiriman APC ke utas saat ini dapat diaktifkan kembali.

Ini adalah kesalahan pemrograman untuk memanggil ExReleaseFastMutex dengan FastMutex yang diperoleh menggunakan ExAcquireFastMutexUnsafe. Driver harus melepaskan mutex cepat dari utas yang sama yang memperolehnya. Mutex cepat harus dilepaskan dalam urutan yang berlawanan dari urutan diperolehnya.

Untuk informasi selengkapnya tentang mutex cepat, lihat Fast Mutexes dan Guarded Mutexes.

Pemanggil ExReleaseFastMutex harus berjalan di IRQL = APC_LEVEL. Dalam kebanyakan kasus, IRQL sudah akan diatur ke APC_LEVEL sebelum ExReleaseFastMutex dipanggil karena ExAcquireFastMutex telah mengatur IRQL ke APC_LEVEL secara otomatis. Namun, jika penelepon mengubah IRQL setelah ExAcquireFastMutex kembali, pemanggil harus secara eksplisit mengatur IRQL ke APC_LEVEL sebelum memanggil ExReleaseFastMutex.