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 ;如果未处理请求,则返回 FALSE 。 如果未处理请求,则会生成 IRP。 如果请求已处理,则函数将 IoStatus-Information> 元素设置为零,因为内部错误或元素由方法处理程序设置。 处理方法时,方法处理程序还会设置 IoStatus-Status> 字段。

注解

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

要求

要求
目标平台 通用
标头 ks.h (包括 Ks.h)
Library Ks.lib

另请参阅

KsMethodHandler