KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR
KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR 用于在驱动程序上启用或禁用高动态范围 (HDR) 视频。 这是仅用于视频固定的固定级别控件。
使用情况摘要表
| 获取 | 设置 | 目标 | 属性描述符类型 |
|---|---|---|---|
| 是 | 是 | Pin | KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR |
以下标志可以放在KSCAMERA_EXTENDEDPROP_HEADER中。用于控制视频 HDR 的标志字段。 默认情况下，驱动程序应设置为 VIDEOHDR_OFF。
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF 0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON 0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO 0x0000000000000002
如果驱动程序支持此控件，它必须支持 VIDEOHDR_ON/VIDEOHDR_OFF。
如果驱动程序不支持视频 HDR，则驱动程序不应实现此控件。
此控件充当驱动程序的提示。 设置为 VIDEOHDR_ON 时，驱动程序应尽最大努力执行视频 HDR。
当视频引脚处于KSSTATE_RUN状态时，此控件的 SET 调用不起作用。 如果视频引脚处于运行状态并返回STATUS_INVALID_DEVICE_STATE，驱动程序应拒绝收到的 SET 调用。 在 GET 调用中，驱动程序应在“标志”字段中返回当前设置。
下表描述了标志功能。
| 标志 | 描述 |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF | 这是一项必需的功能。 指定后，驱动程序中禁用视频 HDR，驱动程序不得对视频流执行视频 HDR。 |
| KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON | 这是一项必需的功能。 指定后，将在驱动程序中启用视频 HDR，驱动程序应尽最大努力执行视频 HDR。 此标志与 VIDEOHDR_AUTO 和 VIDEOHDR_OFF 标志互斥。 |
| KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO | 此功能是可选的。 指定后，支持此功能的驱动程序将确定是否应根据场景分析执行视频 HDR。 此标志与 VIDEOHDR_ON 和 VIDEOHDR_OFF 标志互斥。 |
下表包含使用 控件时 KSCAMERA_EXTENDEDPROP_HEADER 结构字段的说明和要求。
| 成员 | 说明 |
|---|---|
| 版本 | 此值必须为 1。 |
| PinId | 必须是与视频图钉关联的固定 ID。 |
| 大小 | 这必须是 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) 。 |
| 结果 | 指示上次 SET 操作的错误结果。 如果未执行 SET 操作，则必须为 0。 |
| 功能 | 必须是上面定义的受支持KSCAMERA_EXTENDEDPROP_VIDEOHDR_* 标志的按位 OR。 |
| Flags | 这是一个读/写字段。 这可以是上面定义的KSCAMERA_EXTENDEDPROP_VIDEOHDR_* 标志中的任何一个。 |
要求
支持的最低客户端：Windows 11
标头： ksmedia.h (包括 Ksmedia.h)