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.
Un thread che chiama KeAcquireGuardedMutex entra in modo implicito in un'area sorvegliata, in cui tutte le API sono disabilitate. Rimangono disabilitati fino a quando il thread rilascia il mutex con KeReleaseGuardedMutex.
Un mutex sorvegliato non può essere acquisito 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| server minimo supportato | Windows Server 2003 |
| intestazione | wdm.h |
| IRQL | <= APC_LEVEL |
| regole di conformità DDI | HwStorPortProhibitedDDIs(storport), IrqlKeApcLte1(wdm) |