Функция KsFastPropertyHandler (ks.h)
Функция 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 |