Función ExInterlockedAddLargeInteger (wdm.h)

La rutina ExInterlockedAddLargeInteger agrega un valor entero grande a la variable especificada como una operación atómica.

Sintaxis

LARGE_INTEGER ExInterlockedAddLargeInteger(
  [in, out] PLARGE_INTEGER Addend,
  [in]      LARGE_INTEGER  Increment,
  [in, out] PKSPIN_LOCK    Lock
);

Parámetros

[in, out] Addend

Puntero a la variable que se va a ajustar mediante el valor increment .

[in] Increment

Especifica un valor que se va a agregar a Addend.

[in, out] Lock

Puntero a un bloqueo de número que se usará para sincronizar el acceso a Addend.

Valor devuelto

ExInterlockedAddLargeInteger devuelve el valor inicial del parámetro Addend .

Comentarios

Se supone que las rutinas de soporte técnico que realizan operaciones interbloqueadas no pueden causar un error de página. Es decir, ni su código ni ninguno de los datos que tocan pueden provocar un error de página sin bajar el sistema. Usan bloqueos de giro para lograr atomicidad en máquinas de varios procesadores simétricos. El autor de la llamada debe proporcionar almacenamiento residente para el bloqueo, que debe inicializarse con KeInitializeSpinLock antes de la llamada inicial a un ExInterlockedXxx.

El bloqueo pasado a ExInterlockedAddLargeInteger se usa para asegurarse de que la operación de adición en Addend es atómica con respecto a cualquier otra operación en el mismo valor que se sincronice con este mismo bloqueo de número.

ExInterlockedAddLargeInteger enmascara las interrupciones. Por lo tanto, se puede usar para la sincronización entre un ISR y otro código de controlador de dispositivo, siempre que el mismo bloqueo nunca se reutilice en una llamada a una rutina que se ejecuta en IRQL = DISPATCH_LEVEL.

Tenga en cuenta que se garantiza que las llamadas a InterlockedXxx son atómicas con respecto a otras llamadas Xxx interbloqueadas sin bloqueos de número proporcionados por el autor de la llamada.

Los autores de llamadas de ExInterlockedAddLargeInteger se ejecutan en cualquier IRQL. El almacenamiento del parámetro Addend debe residir en todas las IRQL.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows 2000 y versiones posteriores de Windows. No está disponible en Windows 98 o Windows Me.
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	Cualquier nivel (consulte la sección Comentarios)

Consulte también

ExInterlockedAddUlong

InterlockedDecrement

InterlockedIncrement

KeInitializeSpinLock