Função StorPortQueryDepthSList (storport.h)

  • Artigo

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

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.

Retornar valor

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 em SListHead ou Result é NULL.

Comentários

Como StorPortQueryDepthSList não está interligado, o valor de profundidade da lista apontado por Resultado no retorno não é confiável em quando vários threads estão operando na lista.

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

StorPortInterlockedFlushSList

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList