Macro NdisInitializeSListHead (ndis.h)
La función NdisInitializeSListHead inicializa el encabezado de una lista secuenciada, interbloqueada y vinculada de forma singly.
Sintaxis
void NdisInitializeSListHead(
[in] SListHead
);
Parámetros
[in] SListHead
Puntero al encabezado de lista proporcionado por el autor de la llamada que se va a inicializar, que debe estar en memoria residente. La estructura debe estar alineada con 16 bytes en plataformas de 64 bits.
Valor devuelto
None
Observaciones
NdisInitializeSListHead inicializa el encabezado de lista opaco en SListHead y establece el puntero de primera entrada en NULL.
El número de secuencia de una lista de S se incrementa cada vez que se inserta una entrada en la lista o se quita de la lista.
Todas las entradas de una lista de S deben ser no paginadas.
Cualquier controlador que use una lista de S debe proporcionar un bloqueo de número al NdisInterlockedPushEntrySList y Funciones NdisInterlockedPopEntrySList . Antes de su llamada inicial a cualquiera de estas funciones, el controlador debe inicializar el bloqueo de número con la función NdisAllocateSpinLock . Para evitar interbloqueos, el controlador no debe mantener este bloqueo de giro cuando realiza llamadas posteriores a NdisInterlockedPushEntrySList y NdisInterlockedPopEntrySList.
Para administrar un grupo de entradas de tamaño fijo de memoria no paginada, considere la posibilidad de usar una lista de aspecto en lugar de una lista de S-List.
Los controladores que reintenten las operaciones de E/S deben usar una cola interbloqueada doblemente vinculada y las funciones NdisInterlockedInsertHeadList, NdisInterlockedInsertTailList y NdisInterlockedRemoveHeadList , en lugar de una S-List.
Si se llama a NdisInitializeSListHead en IRQL >= DISPATCH_LEVEL, el almacenamiento del parámetro SListHead debe ser residente.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compatible con controladores NDIS 6.0 y NDIS 5.1 (consulte NdisInitializeSListHead (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisInitializeSListHead (NDIS 5.1)) en Windows XP. |
| Plataforma de destino | Escritorio |
| Encabezado | ndis.h (incluya Ndis.h) |
| IRQL | Cualquier nivel |