Função KsHandleSizedListQuery (ks.h)

Artigo
02/07/2025

A função KsHandleSizedListQuery, dependendo do comprimento do buffer do sistema, retorna o tamanho do buffer necessário, o número de entradas na lista de dados especificada ou copia as próprias entradas. Isso pressupõe que a estrutura de KSMULTIPLE_ITEM seja um Tamanho seguido por uma Contagem.

Sintaxe

KSDDKAPI NTSTATUS KsHandleSizedListQuery(
  [in] PIRP       Irp,
  [in] ULONG      DataItemsCount,
  [in] ULONG      DataItemSize,
  [in] const VOID *DataItems
);

Parâmetros

[in] Irp

Especifica o IRP com a solicitação de lista de identificadores.

[in] DataItemsCount

Especifica o número de itens na lista de identificadores.

[in] DataItemSize

Especifica o tamanho de um item de dados.

[in] DataItems

Especifica a lista de itens de dados.

Valor de retorno

A função KsHandleSizedListQuery retorna STATUS_SUCCESS se o número de entradas e os dados puderem ser copiados. Se o buffer for maior que o tamanho para armazenar apenas o tamanho e a contagem de entradas, mas muito pequeno para conter todas as entradas, a função retornará o status STATUS_BUFFER_TOO_SMALL.

Observações

Use a função KsHandleSizedListQuery ao implementar propriedades que devem retornar informações no formato de vários itens.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	ks.h (incluir Ks.h)
biblioteca	Ks.lib

Compartilhar via