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