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 |