KeAcquireGuardedMutex, fonction (wdm.h)
Le KeAcquireGuardedMutex routine acquiert un mutex protégé.
Syntaxe
void KeAcquireGuardedMutex(
PKGUARDED_MUTEX Mutex
);
Paramètres
Mutex
[in, out] Pointeur vers la structure KGUARDED_MUTEX pour le mutex protégé. Cette structure doit avoir été initialisée avec KeInitializeGuardedMutex.
Valeur de retour
Aucun
Remarques
Utilisez KeReleaseGuardedMutex pour libérer un mutex acquis avec KeAcquireGuardedMutex.
Si le mutex est disponible, KeAcquireGuardedMutex retourne immédiatement. Sinon, le thread appelant est placé dans un état d’attente jusqu’à ce que le mutex devienne disponible. Pour éviter d’entrer un état d’attente lorsque le mutex n’est pas disponible, utilisez KeTryToAcquireGuardedMutex.
Thread qui appelle KeAcquireGuardedMutex 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.
Un mutex protégé ne peut pas être acquis de manière récursive : si un thread contient déjà le mutex lorsqu’il appelle KeAcquireGuardedMutex, le thread est bloqué.
Pour plus d’informations sur les mutex guarded, consultez Mutexes rapides et les mutex guarded.
Exigences
| Exigence | Valeur |
|---|---|
| serveur minimum pris en charge | Windows Server 2003 |
| d’en-tête | wdm.h |
| IRQL | <= APC_LEVEL |
| règles de conformité DDI | HwStorPortProhibitedDDIs(storport), IrqlKeApcLte1(wdm) |