Funzione ExTryToAcquireFastMutex (wdm.h)

La routine ExTryToAcquireFastMutex acquisisce il mutex rapido specificato, se possibile, con le API al thread corrente disabilitato.

Sintassi

BOOLEAN ExTryToAcquireFastMutex(
  PFAST_MUTEX FastMutex
);

Parametri

FastMutex

[in, out] Puntatore al mutex veloce da acquisire se non è attualmente di proprietà di un altro thread.

Valore restituito

ExTryToAcquireFastMutex restituisce TRUE se il thread corrente viene assegnato alla proprietà del mutex rapido.

Commenti

Se il mutex rapido specificato è attualmente non generato, ExTryToAcquireFastMutex dà la proprietà del chiamante con le API al thread corrente disabilitato fino a quando non rilascia il mutex veloce.

Usare ExAcquireFastMutex se il thread corrente deve attendere l'acquisizione del mutex specificato prima di poter eseguire operazioni utili.

Qualsiasi mutex veloce acquisito con ExTryToAcquireFastMutex o ExAcquireFastMutex deve essere rilasciato con ExReleaseFastMutex.

Per altre informazioni sui mutex veloci, vedere Mutex veloci e Mutex sorvegliati.

I chiamanti di ExTryToAcquireFastMutex devono essere in esecuzione in IRQL <= APC_LEVEL. ExTryToAcquireFastMutex imposta irQL su APC_LEVEL se il mutex viene acquisito e il chiamante continua a essere eseguito in APC_LEVEL dopo la restituzione di ExTryToAcquireFastMutex . ExTryToAcquireFastMutex salva il precedente IRQL del chiamante nel mutex, tuttavia, e che IRQL viene ripristinato quando il chiamante Chiama ExReleaseFastMutex.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000
Intestazione	wdm.h
IRQL	<= APC_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDDIs(storport), IrqlExApcLte1(wdm)

Vedi anche

FAST_MUTEX

ExAcquireFastMutex

ExInitializeFastMutex

ExReleaseFastMutex