Funzione ExTryToAcquireFastMutex (wdm.h)

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

Sintassi

C++
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 al thread corrente viene assegnata la proprietà del mutex rapido.

Osservazioni

Se il mutex rapido specificato non viene attualmente generato, ExTryToAcquireFastMutex assegna alla proprietà del chiamante la proprietà del chiamante con i controller di accesso 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 ExTryToAcquireFastMutex restituito. ExTryToAcquireFastMutex salva il precedente IRQL del chiamante nel mutex, tuttavia, e che IRQL viene ripristinato quando il chiamante chiama ExReleaseFastMutex.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000
intestazione wdm.h
IRQL <= APC_LEVEL
regole di conformità DDI HwStorPortProhibitedDDDIs(storport), IrqlExApcLte1(wdm)

Vedere anche

FAST_MUTEX

ExAcquireFastMutex

ExInitializeFastMutex

exReleaseFastMutex