Fungsi KeAcquireGuardedMutex (wdm.h)

Rutinitas KeAcquireGuardedMutex memperoleh mutex yang dijaga.

Sintaks

void KeAcquireGuardedMutex(
  PKGUARDED_MUTEX Mutex
);

Parameter

Mutex

[in, out] Arahkan ke struktur KGUARDED_MUTEX untuk mutex yang dijaga. Struktur ini harus diinisialisasi dengan KeInitializeGuardedMutex.

Nilai kembali

Tidak ada

Keterangan

Gunakan KeReleaseGuardedMutex untuk merilis mutex yang diperoleh dengan KeAcquireGuardedMutex.

Jika mutex tersedia, KeAcquireGuardedMutex segera kembali. Jika tidak, utas panggilan dimasukkan ke dalam status tunggu hingga mutex tersedia. Untuk menghindari memasuki status tunggu saat mutex tidak tersedia, gunakan KeTryToAcquireGuardedMutex.

Utas yang memanggil KeAcquireGuardedMutex secara implisit memasuki wilayah yang dijaga, di mana semua APC dinonaktifkan. Mereka tetap dinonaktifkan sampai utas merilis mutex dengan KeReleaseGuardedMutex.

Mutex yang dijaga tidak dapat diperoleh secara rekursif: jika utas sudah memegang mutex ketika memanggil KeAcquireGuardedMutex, utas akan mengalami kebuntuan.

Untuk informasi selengkapnya tentang mutex yang dijaga, lihat Mutex Cepat dan Mutex Terjaga.

Persyaratan

Persyaratan	Nilai
Server minimum yang didukung	Windows Server 2003
Header	wdm.h
IRQL	<= APC_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport), IrqlKeApcLte1(wdm)

Lihat juga

KGUARDED_MUTEX

KeReleaseGuardedMutex