Функция KsHandleSizedListQuery (ks.h)

Функция KsHandleSizedListQuery в зависимости от длины системного буфера возвращает требуемый размер буфера, количество записей в указанном списке данных или копирует сами записи. Предполагается, что структура KSMULTIPLE_ITEM будет иметь значение Size, за которым следует значение Count.

Синтаксис

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

Параметры

[in] Irp

Указывает IRP с запросом списка идентификаторов.

[in] DataItemsCount

Указывает количество элементов в списке идентификаторов.

[in] DataItemSize

Указывает размер элемента данных.

[in] DataItems

Указывает список элементов данных.

Возвращаемое значение

Функция KsHandleSizedListQuery возвращает STATUS_SUCCESS, если можно скопировать количество записей и данных. Если размер буфера превышает размер для хранения только размера и количества записей, но слишком мал для хранения всех записей, функция возвращает состояние STATUS_BUFFER_TOO_SMALL.

Комментарии

Используйте функцию KsHandleSizedListQuery при реализации свойств, возвращающих сведения в формате нескольких элементов.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть ks.h (включая Ks.h)
Библиотека Ks.lib