Macro NdisInterlockedPushEntrySList (ndis.h)

Artículo
02/26/2024

La función NdisInterlockedPushEntrySList inserta una entrada en el encabezado de una lista vinculada secuenciada.

Sintaxis

void NdisInterlockedPushEntrySList(
        SListHead,
        SListEntry,
  [in]  Lock
);

Parámetros

SListHead

Puntero al encabezado de la lista ya inicializada, vinculada de forma cansada en la que se va a insertar la entrada especificada.

SListEntry

Puntero a la entrada que se va a insertar.

[in] Lock

Puntero a un bloqueo de número proporcionado por el autor de la llamada, no mantenido actualmente por el autor de la llamada.

Valor devuelto

None

Observaciones

Antes de que el controlador llame inicialmente a la función NdisInterlockedPushEntrySList , debe inicializar el encabezado de lista con el Función NdisInitializeSListHead .

Un controlador no debe mantener el bloqueo especificado cuando llama a NdisInterlockedPushEntrySList. Si es necesario, un controlador debe llamar a la función NdisReleaseSpinLock antes de llamar a NdisInterlockedPushEntrySList. NdisInterlockedPushEntrySList debe adquirir este bloqueo antes de insertar ListEntry en la cabecera de la lista para asegurarse de que esta operación se controla de forma segura para varios procesadores.

El autor de la llamada debe proporcionar almacenamiento residente para lock, que debe inicializarse con la función NdisAllocateSpinLock antes de la llamada inicial a cualquier NdisInterlocked. Rutina SList .

Los controladores que reintenten las operaciones de E/S deben usar una cola de interbloqueo doblemente vinculada y NdisInterlockedInsert/Remove.. Enumerar funciones, en lugar de una S-List.

Si se llama a NdisInterlockedPushEntrySList en IRQL >= DISPATCH_LEVEL, el almacenamiento del parámetro ListHead y las entradas de lista deben estar residentes.

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisInterlockedPushEntrySList (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisInterlockedPushEntrySList (NDIS 5.1)) en Windows XP.
Plataforma de destino	Escritorio
Encabezado	ndis.h (incluya Ndis.h)
IRQL	Cualquier nivel