KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS

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_VALUE)
Result 必须包含 0。 此字段仅用于返回最后一个异步 SET 操作的结果。
功能 必须为 0。
标记 必须为 0。

KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS 有效负载

标头结构后面的有效负载是必需的 KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGCAPS

参数 说明
DefaultDiagonalFieldOfViewInDegrees 默认视场角 (FoV) 值。 必须是 DiscreteFoVStops 数组中报告的值之一。
DiscreteFoVStopsCount DiscreteFovStops 中有效条目的计数,最大值为 360,最小值为 1。
DiscreteFoVStops 有效场视角 (FoV) 停止的数组,只有 DiscreteFoVStopsCount 是有效项。
Reserved 将 设置为 0。

要求

支持的最低客户端:Windows 11 版本 24H2

头文件:ksmedia.h(包括 Ksmedia.h)

另请参阅

KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGCAPS

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE

KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2