Compartilhar via


Função KsHandleSizedListQuery (ks.h)

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.

Retornar valor

A função KsHandleSizedListQuery retornará 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á status STATUS_BUFFER_TOO_SMALL.

Comentários

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

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho ks.h (inclua Ks.h)
Biblioteca Ks.lib