KeTryToAcquireGuardedMutex, fonction (wdm.h)

  • Article

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)

Voir aussi

KeReleaseGuardedMutex