Функция обратного вызова PFNKSFASTHANDLER (ks.h)

Статья
02/07/2025

KStrFastHandler — это подпрограмма, предоставляемая драйвером, которая обрабатывает запрос свойства или метода без создания IRP.

Синтаксис

PFNKSFASTHANDLER Pfnksfasthandler;

BOOLEAN Pfnksfasthandler(
  [in]      PFILE_OBJECT FileObject,
  [in]      PKSIDENTIFIER Request,
  [in]      ULONG RequestLength,
  [in, out] PVOID Data,
  [in]      ULONG DataLength,
  [out]     PIO_STATUS_BLOCK IoStatus
)
{...}

Параметры

[in] FileObject

Указывает объект файла, в котором был выполнен запрос.

[in] Request

Задает исходный параметр свойства. Это всегда будет на FILE_LONG_ALIGNMENT, но не может быть на FILE_QUAD_ALIGNMENT.

[in] RequestLength

Указывает длину, указанную вызывающим параметром свойства.

[in, out] Data

Указывает исходный неуправляемый параметр данных.

[in] DataLength

Указывает длину, указанную вызывающим параметром данных.

[out] IoStatus

Указывает выровненную структуру, которая используется для возврата состояния ошибки и сведений. Затем эти сведения копируются в исходную структуру состояния ввода-вывода при завершении.

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

KStrFastHandler возвращает TRUE, если вызов был обработан. Если вызов не был обработан, он возвращает FALSE и создается IRP для обработки запроса.

Замечания

Мини-driver предоставляет точку входа для этой подпрограммы в KSFASTPROPERTY_ITEM или KSFASTMETHOD_ITEM.

Требования

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

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