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_ITEMKSFASTMETHOD_ITEM 中为此例程提供入口点。

要求

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