Funzione KeTryToAcquireGuardedMutex (wdm.h)

La routine KeTryToAcquireGuardedMutex acquisisce un mutex sorvegliato, se disponibile.

Sintassi

BOOLEAN KeTryToAcquireGuardedMutex(
  [in, out] PKGUARDED_MUTEX Mutex
);

Parametri

[in, out] Mutex

Puntatore alla struttura KGUARDED_MUTEX per il mutex sorvegliato.

Valore restituito

KeTryToAcquireGuardedMutex restituisce TRUE se il mutex viene acquisito e FALSE in caso contrario.

Commenti

Usare KeReleaseGuardedMutex per rilasciare il mutex.

KeTryToAcquireGuardedMutex restituisce immediatamente, indipendentemente dal fatto che possa acquisire il mutex. Usare KeAcquireGuardedMutex per inserire il thread chiamante in uno stato di attesa fino a quando il mutex non diventa disponibile.

Un thread che chiama KeTryToAcquireGuardedMutex entra in modo implicito in un'area sorvegliata, in cui tutti i controller di accesso sono disabilitati. Rimangono disabilitati fino a quando il thread non rilascia il mutex con KeReleaseGuardedMutex.

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

Requisiti

Vedi anche

KeReleaseGuardedMutex