Fonction KeAcquireGuardedMutexUnsafe (wdm.h)

  • Article

Le KeAcquireGuardedMutexUnsafe acquiert un mutex protégé à l’intérieur d’une région protégée.

Syntaxe

void KeAcquireGuardedMutexUnsafe(
  PKGUARDED_MUTEX FastMutex
);

Paramètres

FastMutex

[in, out] Pointeur vers la structure KGUARDED_MUTEX pour le mutex protégé.

Valeur de retour

None

Remarques

Utilisez KeReleaseGuardedMutexUnsafe pour libérer un mutex protégé acquis avec KeAcquireMutexUnsafe.

KeAcquireGuardedMutexUnsafe ne place pas implicitement le thread appelant dans une région protégée. Le code placé dans une paire KeAcquireGuardedMutexUnsafe/KeReleaseGuardedMutexUnsafe doit s’exécuter à l’adresse IRQL = APC_LEVEL, ou dans une région protégée. Pour le code dont l’exécution n’est pas garantie dans une région protégée, utilisez KeAcquireGuardedMutex et KeReleaseGuardedMutexUnsafe.

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 KeAcquireGuardedMutexUnsafe, le thread est bloqué.

Pour plus d’informations sur les mutex surveillés, consultez Mutexes rapides et Mutexes gardés.

Configuration requise

Condition requise Valeur
Serveur minimal pris en charge Windows Server 2003
En-tête wdm.h
IRQL <= APC_LEVEL
Règles de conformité DDI HwStorPortProhibitedDDIs(storport),IrqlKeApcLte1(wdm)

Voir aussi

KGUARDED_MUTEX

KeReleaseGuardedMutexUnsafe