Funzione KeAcquireGuardedMutexUnsafe (wdm.h)
KeAcquireGuardedMutexUnsafe acquisisce un mutex sorvegliato mentre si trova all'interno di un'area protetta.
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 protetta. Il codice racchiuso in una coppia KeAcquireGuardedMutexUnsafe/KeReleaseGuardedMutexUnsafe deve essere eseguita in IRQL = APC_LEVEL o all'interno di un'area protetta. Per il codice che non è garantito eseguire all'interno di un'area protetta, usare KeAcquireGuardedMutex e KeReleaseGuardedMutexUnsafe.
Non è possibile acquisire un mutex sorvegliato in modo ricorsivo: se un thread mantiene già il mutex quando chiama KeAcquireGuardedMutexUnsafe, 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) |