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.
Osservazioni
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 tutte le API sono disabilitate. Rimangono disabilitati fino a quando il thread rilascia il mutex con KeReleaseGuardedMutex.
Per altre informazioni sui mutex sorvegliati, vedere Mutex veloci e Mutex sorvegliati.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows Server 2003 e versioni successive di Windows. |
| piattaforma di destinazione | Universale |
| intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
| regole di conformità DDI | HwStorPortProhibitedDDIs(storport), IrqlKeApcLte1(wdm) |