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 |