KeTryToAcquireGuardedMutex, fonction (wdm.h)
La routine KeTryToAcquireGuardedMutex acquiert un mutex protégé, si disponible.
Syntaxe
BOOLEAN KeTryToAcquireGuardedMutex(
[in, out] PKGUARDED_MUTEX Mutex
);
Paramètres
[in, out] Mutex
Pointeur vers la structure KGUARDED_MUTEX pour le mutex protégé.
Valeur retournée
KeTryToAcquireGuardedMutex retourne TRUE si le mutex est acquis, et FALSE dans le cas contraire.
Remarques
Utilisez KeReleaseGuardedMutex pour libérer le mutex.
KeTryToAcquireGuardedMutex retourne immédiatement, qu’il puisse ou non acquérir le mutex. Utilisez KeAcquireGuardedMutex pour placer le thread appelant dans un état d’attente jusqu’à ce que mutex devienne disponible.
Un thread qui appelle KeTryToAcquireGuardedMutex entre implicitement dans une région protégée, où tous les API sont désactivés. Ils restent désactivés jusqu’à ce que le thread libère le mutex avec KeReleaseGuardedMutex.
Pour plus d’informations sur les mutex guarded, consultez Mutexes rapides et Mutexe guarded.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows Server 2003 et versions ultérieures de Windows. |
| Plateforme cible | Universal |
| En-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
| Règles de conformité DDI | HwStorPortProhibitedDDIs(storport), IrqlKeApcLte1(wdm) |