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) |