ExAcquireSpinLockExclusive, fonction (wdm.h)
La routine ExAcquireSpinLockExclusive acquiert un verrou de rotation pour l’accès exclusif par l’appelant et déclenche l’IRQL à DISPATCH_LEVEL.
Syntaxe
KIRQL ExAcquireSpinLockExclusive(
PEX_SPIN_LOCK SpinLock
);
Paramètres
SpinLock
[in, out] Pointeur vers le verrou de rotation à acquérir pour un accès exclusif. L’appelant ne doit pas déjà posséder ce verrou de rotation.
Valeur de retour
ExAcquireSpinLockExclusive retourne la valeur IRQL précédente. Pour plus d’informations, consultez Remarques.
Remarques
Lors de l’entrée à cette routine, l’appelant doit s’exécuter au <IRQL = DISPATCH_LEVEL. Cette routine déclenche l’IRQL à DISPATCH_LEVEL et retourne la valeur IRQL d’origine (entrée).
Pour libérer le verrou de rotation, appelez la routine ExReleaseSpinLockExclusive. ExReleaseSpinLockExclusive restaure l’IRQL sur la valeur d’origine qu’elle avait lors de l’entrée dans ExAcquireSpinLockExclusive.
Un verrou de rotation est une variable 32 bits de type EX_SPIN_LOCK. Le pilote doit allouer le stockage pour le verrou de rotation et initialiser le verrou de rotation à zéro. Ce stockage doit se trouver dans la mémoire de l’espace système non paginé.
L’appelant doit contenir le verrou de rotation uniquement brièvement avant de le libérer. Pour plus d’informations, consultez Présentation des verrous de rotation.
L’acquisition récursive d’un verrou de rotation provoque un blocage et n’est pas autorisée.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | wdm.h |
| IRQL | IRQL <= DISPATCH_LEVEL |