KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS 是一个属性 ID,允许相机驱动程序提供多个固定视图(FoV)设置,用户可以通过相机设置页面或应用程序进行选择。
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS 有效负载数组中报告的视图值字段必须按降序排序,例如,首先对最大值进行排序。
驱动程序选择支持的所有可用媒体类型都必须支持由 KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS 报告的所有视图字段(FoV)值。
驱动程序可以执行缩放和/或裁剪,以在某些分辨率上实现 FoV。
可以通过支持相机配置文件并将KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2添加为 BlockedControl 来例外。 这将导致在使用阻止FIELDOFVIEW2控件的配置文件时完全不受支持。
使用情况摘要表
| 范围 | 获取 | 设置 | 控制 | 类型 |
|---|---|---|---|---|
| 版本 1 | 是的 | 否 | 滤波器 | 同步 |
KSCAMERA_EXTENDEDPROP_HEADER结构字段
下表包含使用控件时 KSCAMERA_EXTENDEDPROP_HEADER 结构字段的要求。
| 成员 | 说明 |
|---|---|
| 版本 | 必须为 1。 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE(0xFFFFFFFF) |
| 大小 | 必须是 sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGCAPS) |
| 结果 | 必须包含 0。 此字段仅用于返回最后一个异步 SET作的结果。 |
| 能力 | 必须为 0。 |
| 旗帜 | 必须为 0。 |
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS有效负载
标头结构后面的有效负载是必需的 KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGCAPS。
| 参数 | 说明 |
|---|---|
| DefaultDiagonalFieldOfViewInDegrees | 视图的默认字段 (FoV) 值。 必须是 DiscreteFoVStops 数组中报告的值之一。 |
| DiscreteFoVStopsCount | DiscreteFovStops 中有效条目的计数,最大值为 360,最小值为 1。 |
| DiscreteFoVStops | 有效视图字段 (FoV) 停止的数组,只有 DiscreteFoVStopsCount 是有效项。 |
| 已预留 | 设置为 0。 |
要求
最低支持的客户端: Windows 11 版本 24H2
标头: ksmedia.h (包括 Ksmedia.h)