Funzione ExInterlockedAddLargeInteger (wdm.h)

La routine ExInterlockedAddLargeInteger aggiunge un valore intero di grandi dimensioni alla variabile specificata come operazione atomica.

Sintassi

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

Parametri

[in, out] Addend

Puntatore alla variabile da regolare in base al valore Increment .

[in] Increment

Specifica un valore da aggiungere a Addend.

[in, out] Lock

Puntatore a un blocco spin da usare per sincronizzare l'accesso a Addend.

Valore restituito

ExInterlockedAddLargeInteger restituisce il valore iniziale del parametro Addend .

Commenti

Si presuppone che le routine di supporto che eseguono operazioni interlock non siano in grado di causare un errore di pagina. Ovvero, né il codice né i dati che toccano possono causare un errore di pagina senza arrestare il sistema. Usano blocchi di rotazione per ottenere l'atomicità nei computer multiprocessore simmetrici. Il chiamante deve fornire l'archiviazione residente per il blocco, che deve essere inizializzato con KeInitializeSpinLock prima della chiamata iniziale a un oggettoExInterlocked Xxx.

Il blocco passato a ExInterlockedAddLargeInteger viene usato per garantire che l'operazione di aggiunta su Addend sia atomica rispetto a tutte le altre operazioni sullo stesso valore che si sincronizzano con lo stesso blocco spin.

Le maschere ExInterlockedAddLargeInteger interrompono. Di conseguenza, può essere usato per la sincronizzazione tra un ISR e un altro codice del driver di dispositivo, purché lo stesso blocco non venga mai riutilizzato in una chiamata a una routine eseguita in IRQL = DISPATCH_LEVEL.

Si noti che le chiamate a Interlocked Xxx sono sicuramente atomiche rispetto ad altre chiamate Xxx interlocked senza blocchi di rotazione forniti dal chiamante.

I chiamanti di ExInterlockedAddLargeInteger vengono eseguiti in qualsiasi IRQL. Lo spazio di archiviazione per il parametro Addend deve essere residente in tutti i valori IRQLs.

Requisiti

Vedi anche

ExInterlockedAddUlong

InterlockedDecrement

InterlockedIncrement

KeInitializeSpinLock