KeTryToAcquireGuardedMutex, fonction (wdm.h)
Le KeTryToAcquireGuardedMutex routine acquiert un mutex protégé, le cas échéant.
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 de retour
KeTryToAcquireGuardedMutex retourne TRUE si le mutex est acquis et FALSE sinon.
Remarques
Utilisez KeReleaseGuardedMutex pour libérer le mutex.
KeTryToAcquireGuardedMutex retourne immédiatement, qu’il puisse acquérir le mutex. Utilisez KeAcquireGuardedMutex pour placer le thread appelant dans un état d’attente jusqu’à ce que mutex devienne disponible.
Thread qui appelle KeTryToAcquireGuardedMutex entre implicitement dans une région protégée, où toutes les API sont désactivées. 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 les mutex guarded.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Server 2003 et versions ultérieures de Windows. |
| plateforme cible | Universel |
| d’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) |