KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL

KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY枚举中定义的KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL属性 ID 用于获取或配置 ROI 设置并应用所需的处理。

使用情况摘要表

作用域 控制 类型

版本 1

筛选器

异步、可取消

若要从驱动程序获取当前 ROI 设置或配置 ROI 设置并应用所需的处理 (3As) , KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL 扩展属性控件将连同标准 KSCAMERA_EXTENDEDPROP_HEADER 结构一起发送到驱动程序,后跟 KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER 结构后跟 KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL 结构,然后按一个或多个相应的 ISP 特定的控制有效负载结构。 以下列表演示了具有一个焦点 ROI 和两个曝光 ROI 的数据结构布局。

  • KSCAMERA_EXTENDEDPROP_HEADER

  • KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER

  • KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL (焦点)

  • KSCAMERA_EXTENDEDPROP_ROI_FOCUS

  • 使用 2 个 ROIS) KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL (曝光

  • KSCAMERA_EXTENDEDPROP_ROI_EXPOSURE (ROI 1)

  • KSCAMERA_EXTENDEDPROP_ROI_EXPOSURE (ROI 2)

下表包含使用扩展 ROI 控件的 KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL 属性时KSCAMERA_EXTENDEDPROP_HEADER结构字段的说明和要求。

成员 说明

版本

这必须是 1,

PinId

这必须 KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) ,

大小

对于初始 GET 调用 (,如果没有进行 SET 调用,) 此调用的大小必须为 (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER) 。 此外,驱动程序必须在 ControlCount 内在其 ISO 控制标头有效负载中返回 0。

对于任何其他 SET 或 GET 调用, 这必须是 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof ( (KSCAMERA_EXTENDEDPROP_ ROI_ISPCONTROLHEADER) + ControlCount * sizeof (KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL) + sizeof (KSCAMERA_EXTENDEDPROP_ROI_FOCUS) * ROICount (焦点) + 大小 () * ROICount (曝光) KSCAMERA_EXTENDEDPROP_EXPOSURE + 大小 (KSCAMERA_EXTENDEDPROP_WHITEBALANCE) * ROICount (whitebalance) 。

结果

这表示上一个 SET 操作的错误结果。 如果未执行 SET 操作,则必须为 0。 值 0 指示未针对配置的所有 ISP 控件检测到任何错误。

功能

这必须是按位或 KSCAMERA_EXTENDEDPROP_CAPS_ASYNCONTROLKSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE

Flags

这是一个读/写字段,这可能是 SET 调用 的KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATION 。 对于 GET 调用,这必须为 0。

可调整输出窗口注意事项

发送到相机的 3A ROI 坐标相对于相机的当前输出窗口发送。 如果由于使用缩放、平移或倾斜或数字窗口等控件而修改了视图字段,则相机 (或实现数字窗口/PTZ) 控件的组件负责将所提供的坐标映射回传感器的完整视野,并考虑当前输出窗口以确保相机的 3A 算法面向正确的位置。 根据视图修改字段的发生位置,坐标映射可能需要双向。 例如,如果相机使用 Windows 平台 DMFT 进行人脸检测,但在驱动程序链中的平台 DMFT 之后,应用程序提供的 ROI 坐标需要在驱动程序链中的平台 DMFT 之后在组件中实现,在发送到相机之前,需要将应用程序提供的 ROI 坐标映射回整个视场,然后才能将平台 DMFT 中计算的 ROI 坐标映射到修改后的视野,发送到请求它们的应用。

要求

标头

Ksmedia.h