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

Статья
02/07/2025

Функция KsFastPropertyHandler обрабатывает быстрые запросы свойств через IOCTL_KS_PROPERTY. Он реагирует на все идентификаторы свойств, определенные наборами, которые также содержатся в списке быстрых операций ввода-вывода. Эта функция может вызываться только в PASSIVE_LEVEL.

Синтаксис

KSDDKAPI BOOLEAN KsFastPropertyHandler(
  PFILE_OBJECT         FileObject,
  PKSPROPERTY          Property,
  ULONG                PropertyLength,
  PVOID                Data,
  ULONG                DataLength,
  PIO_STATUS_BLOCK     IoStatus,
  ULONG                PropertySetsCount,
  const KSPROPERTY_SET *PropertySet
);

Параметры

FileObject

Property

PropertyLength

Data

DataLength

IoStatus

PropertySetsCount

PropertySet

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

Функция KsFastPropertyHandler возвращает TRUE, если запрос был обработан или FALSE, если запрос не был обработан. Если возвращается FALSE, создается IRP. Если запрос был обработан, функция задает элемент IoStatus->Information, либо установив его на нулевое значение из-за внутренней ошибки, либо с помощью параметра обработчика свойств. Обработчик свойств также задает поле состояния IoStatus>, когда свойство фактически обрабатывается.

Замечания

Владелец набора свойств может выполнять префильтровку или postfiltering обработки свойств, а также обрабатывать запросы, выполненные через быстрый интерфейс отправки ввода-вывода для управления устройствами. Функция KsFastPropertyHandler используется только для обработки запросов, которые можно быстро выполнить. Параметр wait функции быстрого ввода-вывода не передается и предполагается, что TRUE.

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	ks.h (include Ks.h)
библиотеки	Ks.lib

См. также

KsPropertyHandler

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