KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM

KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM 是一个属性 ID，用于控制驱动程序生成的直方图元数据。 这是仅用于预览引脚的引脚级别控件。

使用情况摘要表

范围	控制	类型
版本 1	Pin	同步

以下标志可以放置在 KSCAMERA_EXTENDEDPROP_HEADER中。用于 控制驱动程序中直方图元数据的标志字段。 默认值为 HISTOGRAM_OFF。

#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_OFF      0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_ON       0x0000000000000001

必须在 KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA 控件之前使用此控件，以确保分配大小正确的元数据缓冲区。

如果设置为 HISTOGRAM_OFF，驱动程序不应在预览引脚上传送直方图元数据。 驱动程序不应在其元数据缓冲区大小要求中包含直方图元数据大小。

如果设置为 HISTOGRAM_ON，驱动程序应在预览引脚上传送直方图元数据。 驱动程序必须在其元数据缓冲区大小要求中包含直方图元数据大小。

如果驱动程序无法生成直方图元数据，则驱动程序不应实现此控件。 如果驱动程序支持此控件，则它还必须支持 KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA 控件。

当预览引脚处于高于KSSTATE_STOP状态的任何状态时，此控件的 SET 调用不起作用。 如果预览版不处于停止状态并返回STATUS_INVALID_DEVICE_STATE，驱动程序应拒绝收到的 SET 调用。 在 GET 调用中，驱动程序应返回 Flags 字段中的 当前设置。

下表包含使用 控件时 KSCAMERA_EXTENDEDPROP_HEADER 结构字段的说明和要求。

成员	说明
版本	这必须为 1。
PinId	必须是与预览引脚关联的 Pin ID。
大小	此大小必须为 (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) 。
结果	指示上次 SET 操作的错误结果。 如果未发生 SET 操作，则必须为 0。
功能	必须为 0。
Flags	这是一个读/写字段。 这可以是上面定义的 任意一个KSCAMERA_EXTENDEDPROP_HISTOGRAM_* 标志。

要求

标头

Ksmedia.h