Fungsi ExAcquireFastMutex (wdm.h)

Rutinitas ExAcquireFastMutex memperoleh mutex cepat yang diberikan dengan APC ke utas saat ini yang dinonaktifkan.

Sintaks

void ExAcquireFastMutex(
  PFAST_MUTEX FastMutex
);

Parameter

FastMutex

[in, out] Penunjuk ke mutex cepat yang diinisialisasi yang disediakan pemanggil penyimpanan.

Nilai kembali

Tidak ada

Keterangan

ExAcquireFastMutex menempatkan pemanggil ke dalam status tunggu jika mutex cepat yang diberikan tidak dapat segera diperoleh. Jika tidak, penelepon diberikan kepemilikan mutex cepat dengan APC ke utas saat ini dinonaktifkan sampai merilis mutex cepat.

Gunakan ExTryToAcquireFastMutex jika utas saat ini dapat melakukan pekerjaan lain sebelum menunggu akuisisi mutex yang diberikan.

Setiap mutex cepat yang diperoleh menggunakan ExAcquireFastMutex atau ExTryToAcquireFastMutex harus dirilis dengan ExReleaseFastMutex.

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

Pemanggil ExAcquireFastMutex harus berjalan di IRQL <= APC_LEVEL. ExAcquireFastMutex mengatur IRQL ke APC_LEVEL, dan pemanggil terus berjalan pada APC_LEVEL setelah ExAcquireFastMutex kembali. ExAcquireFastMutex menyimpan IRQL pemanggil sebelumnya dalam mutex, namun, dan IRQL tersebut dipulihkan ketika pemanggil memanggil ExReleaseFastMutex.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000
Header	wdm.h
IRQL	<= APC_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport), IrqlExApcLte1(wdm)

Lihat juga

FAST_MUTEX

ExAcquireFastMutexUnsafe

ExInitializeFastMutex

ExReleaseFastMutex

ExTryToAcquireFastMutex