Funzione KeAcquireGuardedMutex (wdm.h)

La routine KeAcquireGuardedMutex acquisisce un mutex sorvegliato.

Sintassi

void KeAcquireGuardedMutex(
  PKGUARDED_MUTEX Mutex
);

Parametri

Mutex

[in, out] Puntatore alla struttura KGUARDED_MUTEX per il mutex sorvegliato. Questa struttura deve essere stata inizializzata con KeInitializeGuardedMutex.

Valore restituito

nessuno

Osservazioni

Usare KeReleaseGuardedMutex per rilasciare un mutex acquisito con KeAcquireGuardedMutex.

Se il mutex è disponibile, KeAcquireGuardedMutex restituisce immediatamente. In caso contrario, il thread chiamante viene inserito in uno stato di attesa fino a quando il mutex non diventa disponibile. Per evitare di immettere uno stato di attesa quando il mutex non è disponibile, usare KeTryToAcquireGuardedMutex.

Thread che chiama KeAcquireGuardedMutex in modo implicito entra in un'area protetta, in cui tutte le API sono disabilitate. Rimangono disabilitati fino a quando il thread rilascia il mutex con KeReleaseGuardedMutex.

Non è possibile acquisire un mutex sorvegliato in modo ricorsivo: se un thread contiene già il mutex quando chiama KeAcquireGuardedMutex, il thread verrà deadlock.

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

Requisiti

Requisito	Valore
Server minimo supportato	Windows Server 2003
Intestazione	wdm.h
IRQL	<= APC_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDDIs(storport), IrqlKeApcLte1(wdm)

Vedi anche

KGUARDED_MUTEX

KeReleaseGuardedMutex