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

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 для обработки запроса.

Комментарии

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

Требования

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