ExAcquireSpinLockExclusive, fonction (wdm.h)

  • Article

La routine ExAcquireSpinLockExclusive acquiert un verrou de rotation pour un 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 retournée

ExAcquireSpinLockExclusive retourne la valeur IRQL précédente. Pour plus d'informations, consultez la section Notes.

Remarques

Lors de l’entrée dans cette routine, l’appelant doit être en cours d’exécution sur IRQL <= DISPATCH_LEVEL. Cette routine élève 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 à la valeur d’origine qu’il 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 ne doit maintenir le verrou de rotation que 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 interblocage et n’est pas autorisée.

Configuration requise

Condition requise Valeur
En-tête wdm.h
IRQL IRQL <= DISPATCH_LEVEL

Voir aussi

ExReleaseSpinLockExclusive