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 |