Macro NdisDprAcquireSpinLock (ndis.h)

Articolo
03/05/2024

La funzione NdisDprAcquireSpinLock acquisisce un blocco spin in modo che il chiamante possa sincronizzare l'accesso alle risorse condivise tra le funzioni driver non ISR in modo multiprocessore sicuro.

Sintassi

void NdisDprAcquireSpinLock(
  [in]  _SpinLock
);

Parametri

[in] _SpinLock

Puntatore a un blocco spin opaco, già inizializzato dal chiamante.

Valore restituito

nessuno

Osservazioni

Il driver miniport deve inizializzare una variabile di tipo NDIS_SPIN_LOCK con NdisAllocateSpinLock prima di chiamare qualsiasi altro Ndis.. Funzione SpinLock . Il driver deve fornire l'archiviazione residente per i blocchi di rotazione usati.

NdisDprAcquireSpinLock è una versione ottimizzata di NdisAcquireSpinLock che un driver miniport può chiamare solo durante l'esecuzione in IRQL = DISPATCH_LEVEL.

Dopo aver acquisito un blocco spin con NdisDprAcquireSpinLock, il chiamante deve rilasciare tale blocco con una chiamata a NdisDprReleaseSpinLock. Un driver miniport deve chiamare NdisDprReleaseSpinLock seguendo ogni chiamata a NdisDprAcquireSpinLock. In caso contrario, si verifica un deadlock, appeso al driver.

Un blocco di spin acquisito con NdisDprAcquireSpinLock deve essere rilasciato con NdisDprReleaseSpinLock. Un blocco di spin acquisito con NdisAcquireSpinLock deve essere rilasciato con NdisReleaseSpinLock.

Un driver non deve mai contenere un blocco di rotazione per un periodo esteso (più di alcune istruzioni). Il blocco di rotazione per più di 25 microsecondi riduce le prestazioni del sistema e del driver.

Un driver miniport non può usare un blocco spin per proteggere le risorse che le altre funzioni condividono con MiniportInterrupt e/o Funzioni MiniportDisableInterruptEx . Invece, un driver miniport deve chiamare NdisMSynchronizeWithInterruptEx in modo che il relativo La funzione MiniportSynchronizeInterrupt accede a tali risorse condivise allo stesso DIRQL in corrispondenza del quale ha
Le funzioni MiniportInterrupt e/o MiniportDisableInterruptEx.

Per altre informazioni sull'acquisizione e il rilascio dei blocchi di spin NDIS, vedere Sincronizzazione e notifica nei driver di rete.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisDprAcquireSpinLock (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisDprAcquireSpinLock (NDIS 5.1) in Windows XP.
Piattaforma di destinazione	Universale
Intestazione	ndis.h (includere Ndis.h)
Libreria	Ndis.lib
IRQL	DISPATCH_LEVEL
Regole di conformità DDI	Irql_Synch_Function(ndis), SpinLock(ndis), SpinLockBalanced(ndis), SpinLockDpr(ndis), SpinLockDprRelease (ndis), SpinlockRelease(ndis )