Funzione KeAcquireGuardedMutexUnsafe (wdm.h)
Il KeAcquireGuardedMutexUnsafe acquisisce un mutex sorvegliato all'interno di un'area sorvegliata.
Sintassi
void KeAcquireGuardedMutexUnsafe(
PKGUARDED_MUTEX FastMutex
);
Parametri
FastMutex
[in, out] Puntatore alla struttura KGUARDED_MUTEX per il mutex sorvegliato.
Valore restituito
Nessuno
Osservazioni
Usare KeReleaseGuardedMutexUnsafe per rilasciare un mutex sorvegliato acquisito con KeAcquireMutexUnsafe.
KeAcquireGuardedMutexUnsafe non inserisce implicitamente il thread chiamante all'interno di un'area sorvegliata. Il codice racchiuso in una coppia KeAcquireGuardedMutexUnsafe/KeReleaseGuardedMutexUnsafe deve essere eseguito in IRQL = APC_LEVEL o all'interno di un'area protetta. Per il codice non garantito per l'esecuzione all'interno di un'area protetta, usare KeAcquireGuardedMutex e KeReleaseGuardedMutexUnsafe.
Un mutex sorvegliato non può essere acquisito in modo ricorsivo: se un thread contiene già il mutex quando chiama KeAcquireGuardedMutexUnsafe, 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) |