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> 字段。
注解
方法集的所有者可以使用 KsFastMethodHandler 和 KsMethodHandler 函数对方法处理执行预筛选或后筛选。 KsFastMethodHandler 函数用于处理通过设备控制的快速 I/O 调度接口发出的请求。 它仅用于处理可以快速完成的请求。 不传递快速 I/O 函数的 Wait 参数,并假定为 TRUE。
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
标头 | ks.h (包括 Ks.h) |
Library | Ks.lib |