Partager via


ExInterlockedAddUlong, fonction (wdm.h)

La routine ExInterlockedAddUlong ajoute une valeur longue non signée à un entier non signé donné en tant qu’opération atomique.

Syntaxe

ULONG ExInterlockedAddUlong(
  [in, out] PULONG      Addend,
  [in]      ULONG       Increment,
  [in, out] PKSPIN_LOCK Lock
);

Paramètres

[in, out] Addend

Pointeur vers un entier long non signé dont la valeur doit être ajustée par la valeur Incrémenter.

[in] Increment

Spécifie un entier long non signé à ajouter.

[in, out] Lock

Pointeur vers un verrou de rotation à utiliser pour synchroniser l’accès au Addend.

Valeur de retour

ExInterlockedAddUlong retourne la valeur d’origine (non énumérée) du Addend.

Remarques

Envisagez d’utiliser interlockedExchangeAdd au lieu de cette routine. interlockedExchangeAdd peut être plus efficace, car il n’utilise pas de verrou de rotation et il est inline par le compilateur.

Les routines de support qui effectuent des opérations interblocées sont supposées être incapables d’entraîner une erreur de page. Autrement dit, ni leur code ni les données qu’ils touchent ne peuvent provoquer une erreur de page sans réduire le système. Ils utilisent des verrous de rotation pour obtenir l’atomicité sur les machines multiprocesseurs symétriques. L’appelant doit fournir un stockage résident pour le de verrouillage, qui doit être initialisé avec KeInitializeSpinLock avant l’appel initial à un ExInterlockedXxx.

Le de verrouillage passé à ExInterlockedAddULong est utilisé pour garantir que l’opération d’ajout sur Addend est atomique par rapport aux autres opérations sur la même valeur qui se synchronisent avec ce même verrou de rotation.

ExInterlockedAddUlong interrompt les masques. Par conséquent, il peut être utilisé pour la synchronisation entre un ISR et un autre code de pilote, à condition que le même lock ne soit jamais réutilisé dans un appel à une routine qui s’exécute à IRQL = DISPATCH_LEVEL.

Notez que les appels à interblocageXxx sont assurés d’être atomiques par rapport à d’autres appels interblocésXxx sans verrous de rotation fournis par l’appelant.

Les appelants de ExInterlockedAddUlong s’exécutent à n’importe quel irQL. Le stockage du paramètre Addend doit être résident à tous les IRQL.

Exigences

Exigence Valeur
client minimum pris en charge Disponible à partir de Windows 2000.
plateforme cible Universel
d’en-tête wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL N’importe quel niveau (voir section Remarques)

Voir aussi

ExInterlockedAddLargeInteger

InterlockedDecrement

interlockedIncrement

KeInitializeSpinLock