Función StorPortInitializeSListHead (storport.h)

Inicializa el encabezado de una lista vinculada administrada por Storport.

Sintaxis

ULONG StorPortInitializeSListHead(
  [in]      PVOID              HwDeviceExtension,
  [in, out] PSTOR_SLIST_HEADER SListHead
);

Parámetros

[in] HwDeviceExtension

Puntero a la extensión de dispositivo de hardware para el adaptador de bus host (HBA).

[in, out] SListHead

Puntero a una estructura STOR_SLIST_HEADER que representa el encabezado de una lista vinculada de forma singly. Esta estructura se considera opaca y solo la usa el controlador storport.

Valor devuelto

StorPortInitializeSListHead devuelve uno de los siguientes códigos de estado:

Código devuelto	Descripción
STOR_STATUS_NOT_IMPLEMENTED	Esta función no se implementa en el sistema operativo activo.
STOR_STATUS_SUCCESS	El encabezado de lista al que apunta SListHead se inicializó correctamente.
STOR_STATUS_INVALID_PARAMETER	El puntero de SListHead es NULL.

Comentarios

Cuando el autor de la llamada asigna, la estructura de STOR_SLIST_HEADER a la que apunta SListHead debe alinearse en un límite de MEMORY_ALLOCATION_ALIGNMENT . MEMORY_ALLOCATION_ALIGNMENT se define en miniport.h.

Cuando se libera la memoria del encabezado de lista, cualquier código de desasignación debe tener en cuenta la ubicación original del búfer que contiene la estructura principal de la lista antes del ajuste de MEMORY_ALLOCATION_ALIGNMENT.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en a partir de Windows 8.
Plataforma de destino	Universal
Encabezado	storport.h (incluya Storport.h)
IRQL	<= DISPATCH_LEVEL

Consulte también

StorPortInterlockedFlushsList

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrysList

StorPortQueryDepthsList