Função StorPortInterlockedFlushSList (storport.h)

  • Artigo

Remove todos os itens de uma lista vinculada do Storport gerenciada. O acesso à lista é sincronizado em um sistema multiprocessador

Sintaxe

ULONG StorPortInterlockedFlushSList(
  [in]      PVOID              HwDeviceExtension,
  [in, out] PSTOR_SLIST_HEADER SListHead,
  [out]     PSTOR_SLIST_ENTRY  *Result
);

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.

[out] Result

Um ponteiro para um ponteiro de entrada de lista. O valor retornado é um ponteiro para os itens removidos da lista. Se a lista estiver vazia, NULL será retornado no valor apontado por Result.

Retornar valor

StorPortInterlockedFlushSList 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
 Os itens da lista foram removidos com êxito ou a lista já está vazia.
STOR_STATUS_INVALID_PARAMETER
 Um ponteiro em SListHead ou Result é NULL.

Comentários

O StorPortInterlockedFlushSList também retornará STATUS_SUCCESS quando nenhuma entrada estiver na lista. O valor do ponteiro referenciado por Result deve ser avaliado para NULL para verificar se nenhuma entrada foi retornada.

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

StorPortInitializeSListHead

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList

StorPortQueryDepthSList