Função StorPortQueryDepthSList (storport.h)

Artigo
02/07/2025

Recupera o número de entradas em uma lista vinculada gerenciada pelo Storport.

Sintaxe

ULONG StorPortQueryDepthSList(
  [in]      PVOID              HwDeviceExtension,
  [in, out] PSTOR_SLIST_HEADER SListHead,
  [out]     PSHORT             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 valor SHORT que recebe a contagem de profundidade da lista.

Valor de retorno

StorPortQueryDepthSList 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	A profundidade da lista foi retornada com êxito.
STOR_STATUS_INVALID_PARAMETER	Um ponteiro no SListHead ou de Resultado é NULL.

Observações

Como StorPortQueryDepthSList não está intertravado, o valor de profundidade da lista apontado pelo Result no retorno não é confiável quando vários threads estão operando na lista.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível para começar com o Windows 8.
da Plataforma de Destino	Universal
cabeçalho	storport.h (inclua Storport.h)
IRQL	<= DISPATCH_LEVEL

Consulte também

StorPortInitializeSListHead

StorPortInterlockedFlushSList

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList

Partilhar via