Fungsi ExTryToAcquireFastMutex (wdm.h)

Rutinitas ExTryToAcquireFastMutex memperoleh mutex cepat yang diberikan, jika memungkinkan, dengan APC ke utas saat ini dinonaktifkan.

Sintaks

BOOLEAN ExTryToAcquireFastMutex(
  PFAST_MUTEX FastMutex
);

Parameter

FastMutex

[in, out] Penunjuk ke mutex cepat yang akan diperoleh jika saat ini tidak dimiliki oleh utas lain.

Nilai kembali

ExTryToAcquireFastMutex mengembalikan TRUE jika utas saat ini diberikan kepemilikan mutex cepat.

Keterangan

Jika mutex cepat yang diberikan saat ini tidak diberikan, ExTryToAcquireFastMutex memberikan kepemilikan pemanggil dengan APC ke utas saat ini dinonaktifkan hingga merilis mutex cepat.

Gunakan ExAcquireFastMutex jika utas saat ini harus menunggu akuisisi mutex yang diberikan sebelum dapat melakukan pekerjaan yang berguna.

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

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

Penelepon ExTryToAcquireFastMutex harus berjalan di IRQL <= APC_LEVEL. ExTryToAcquireFastMutex mengatur IRQL ke APC_LEVEL jika mutex diperoleh, dan pemanggil terus berjalan pada APC_LEVEL setelah ExTryToAcquireFastMutex kembali. ExTryToAcquireFastMutex menyimpan IRQL pemanggil sebelumnya dalam mutex jika berhasil, 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

ExAcquireFastMutex

ExInitializeFastMutex

ExReleaseFastMutex