Fonction KeAcquireGuardedMutexUnsafe (wdm.h)
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) |