Fungsi KeAcquireGuardedMutexUnsafe (wdm.h)
KeAcquireGuardedMutexUnsafe memperoleh mutex yang dijaga saat berada di dalam wilayah yang dijaga.
Sintaks
void KeAcquireGuardedMutexUnsafe(
PKGUARDED_MUTEX FastMutex
);
Parameter
FastMutex
[in, out] Arahkan ke struktur KGUARDED_MUTEX untuk mutex yang dijaga.
Nilai kembali
Tidak ada
Keterangan
Gunakan KeReleaseGuardedMutexUnsafe untuk merilis mutex terjaga yang diperoleh dengan KeAcquireMutexUnsafe.
KeAcquireGuardedMutexUnsafe tidak secara implisit menempatkan utas panggilan dalam wilayah yang dijaga. Kode yang diapit dalam pasangan KeAcquireGuardedMutexUnsafe/KeReleaseGuardedMutexUnsafe harus dijalankan baik di IRQL = APC_LEVEL, atau dalam wilayah yang dijaga. Untuk kode yang tidak dijamin untuk dijalankan dalam wilayah yang dijaga, gunakan KeAcquireGuardedMutex dan KeReleaseGuardedMutexUnsafe.
Mutex yang dijaga tidak dapat diperoleh secara rekursif: jika utas sudah memegang mutex ketika memanggil KeAcquireGuardedMutexUnsafe, 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) |