KsFastMethodHandler 函数 (ks.h)

KsFastMethodHandler 函数处理通过IOCTL_KS_METHOD请求的快速方法。 它响应由包含在快速 I/O 列表中的集定义的所有方法标识符。 此函数只能在PASSIVE_LEVEL调用。

语法

KSDDKAPI BOOLEAN KsFastMethodHandler(
  [in]      PFILE_OBJECT       FileObject,
  [in]      PKSMETHOD          Method,
  [in]      ULONG              MethodLength,
  [in, out] PVOID              Data,
  [in]      ULONG              DataLength,
  [out]     PIO_STATUS_BLOCK   IoStatus,
  [in]      ULONG              MethodSetsCount,
  [in]      const KSMETHOD_SET *MethodSet
);

参数

[in] FileObject

指定发出请求的文件对象。

[in] Method

指定原始方法参数。 这始终在FILE_LONG_ALIGNMENT上,但可能不会在FILE_QUAD_ALIGNMENT上。

[in] MethodLength

指定方法参数调用方指示的长度。

[in, out] Data

指定原始无对齐数据参数。

[in] DataLength

指定数据参数调用方指示的长度。

[out] IoStatus

指定用于返回错误状态和信息的对齐结构。

[in] MethodSetsCount

指示要传递的方法集结构数。

[in] MethodSet

指定指向方法集信息的列表的指针。

返回值

KsFastMethodHandler 函数在处理请求时返回 true true;如果未处理请求,FALSE。 如果未处理请求,则会生成 IRP。 如果处理了请求,该函数将 IoStatus->Information 元素设置为零,因为内部错误或元素由方法处理程序设置。 方法处理程序还会在处理方法时设置 IoStatus->Status 字段。

言论

方法集的所有者可以使用 KsFastMethodHandlerKsMethodHandler 函数执行方法处理的预筛选或后期筛选。 KsFastMethodHandler 函数用于处理通过设备控制快速 I/O 调度接口发出的请求。 它仅用于处理可以快速完成的请求。 不传递快速 I/O 函数的 Wait 参数,并假定为 true

要求

要求 价值
目标平台 普遍
标头 ks.h (包括 Ks.h)
Ks.lib

另请参阅

KsMethodHandler