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)

Lihat juga

KGUARDED_MUTEX

KeReleaseGuardedMutexUnsafe