KsFastPropertyHandler 函数 (ks.h)

KsFastPropertyHandler 函数通过IOCTL_KS_PROPERTY处理快速属性请求。 它响应由集定义的所有属性标识符,这些集也包含在快速 I/O 列表中。 只能在PASSIVE_LEVEL调用此函数。

语法

KSDDKAPI BOOLEAN KsFastPropertyHandler(
  PFILE_OBJECT         FileObject,
  PKSPROPERTY          Property,
  ULONG                PropertyLength,
  PVOID                Data,
  ULONG                DataLength,
  PIO_STATUS_BLOCK     IoStatus,
  ULONG                PropertySetsCount,
  const KSPROPERTY_SET *PropertySet
);

参数

FileObject

Property

PropertyLength

Data

DataLength

IoStatus

PropertySetsCount

PropertySet

返回值

如果已处理请求, KsFastPropertyHandler 函数返回 TRUE ;如果未处理请求,则返回 FALSE 。 如果返回 FALSE ,则会生成 IRP。 如果请求已处理,则函数会设置 IoStatus-Information> 元素,因为内部错误而将其设置为零,或者通过属性处理程序对其进行设置。 当实际处理属性时,属性处理程序还会设置 IoStatus-Status> 字段。

注解

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

要求

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

另请参阅

KsPropertyHandler