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

Статья
02/29/2024

Функция 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-Status> при фактической обработке свойства.

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

Требования

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

См. также раздел

KsPropertyHandler

Share via