Compartilhar via


Função StorPortInitializeSListHead (storport.h)

Inicializa o cabeçalho de uma lista vinculada do Storport.

Sintaxe

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

Parâmetros

[in] HwDeviceExtension

Um ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador de barramento de host).

[in, out] SListHead

Um ponteiro para uma estrutura STOR_SLIST_HEADER que representa o cabeçalho de uma lista vinculada. Essa estrutura é considerada opaca e é usada apenas pelo driver storport.

Retornar valor

StorPortInitializeSListHead retorna um dos seguintes códigos de status:

Código de retorno Descrição
STOR_STATUS_NOT_IMPLEMENTED
Essa função não é implementada no sistema operacional ativo.
STOR_STATUS_SUCCESS
O cabeçalho da lista apontado por SListHead foi inicializado com êxito.
STOR_STATUS_INVALID_PARAMETER
O ponteiro em SListHead é NULL.

Comentários

Quando alocada pelo chamador, a estrutura de STOR_SLIST_HEADER apontada por SListHead deve ser alinhada em um limite de MEMORY_ALLOCATION_ALIGNMENT . MEMORY_ALLOCATION_ALIGNMENT é definido em miniport.h.

Quando a memória do cabeçalho da lista é liberada, qualquer código de desalocação deve considerar o local original do buffer que contém a estrutura de cabeçalho da lista antes do ajuste para MEMORY_ALLOCATION_ALIGNMENT.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível em começando com Windows 8.
Plataforma de Destino Universal
Cabeçalho storport.h (inclua Storport.h)
IRQL <= DISPATCH_LEVEL

Confira também

StorPortInterlockedFlushSList

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList

StorPortQueryDepthSList