Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La función NdisInitializeSListHead inicializa el encabezado de una lista secuenciada, interbloqueada y vinculada.
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
Ninguno
Observaciones
NdisInitializeSListHead inicializa sin inicializar la lista opaca 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 o quita una entrada de la lista.
Todas las entradas de una lista de S deben no paginarse.
Cualquier controlador que use una lista de S debe proporcionar un bloqueo de giro al NdisInterlockedPushEntrySList y funciones de 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 contener 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 lookaside 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 NdisInterlockedInsertHeadList, NdisInterlockedInsertTailList, y NdisInterlockedRemoveHeadList funciones, en lugar de una S-List.
Si se llama a NdisInitializeSListHead en IRQL >= DISPATCH_LEVEL, el almacenamiento del parámetro SListHead debe estar residente.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Compatible con controladores NDIS 6.0 y NDIS 5.1 (consulte NdisInitializeSListHead (NDIS 5.1)) en Windows Vista. Compatible con controladores NDIS 5.1 (consulte NdisInitializeSListHead (NDIS 5.1)) en Windows XP. |
| de la plataforma de destino de | Escritorio |
| encabezado de | ndis.h (incluya Ndis.h) |
| irQL | Cualquier nivel |