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

指定用于返回错误状态和信息的对齐结构。 完成后，此信息将复制到原始 I/O 状态结构。

返回值

如果已处理调用，KStrFastHandler 将返回 TRUE。 如果未处理调用，则返回 FALSE ，并生成 IRP 来处理请求。

注解

微型驱动程序在 KSFASTPROPERTY_ITEM 或 KSFASTMETHOD_ITEM 中为此例程提供入口点。

要求

要求	值
目标平台	桌面
标头	ks.h (包括 Ks.h)