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

Voir aussi

KeReleaseGuardedMutex