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

Статья
02/07/2025

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

Синтаксис

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 (include Ks.h)
библиотеки	Ks.lib

Поделиться через