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 个 ROI 的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) 。 此外，驱动程序必须在其 ISO 控制标头有效负载的 ControlCount 内返回 0。

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

结果

这表示上次 SET 操作的错误结果。 如果未执行 SET 操作，则必须为 0。 值 0 表示未检测到配置的所有 ISP 控件的错误。

功能

这必须是KSCAMERA_EXTENDEDPROP_CAPS_ASYNCONTROL和KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE的位 OR。

Flags

这是一个读/写字段，对于 SET 调用，可以 KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATION 。 对于 GET 调用，此值必须为 0。

可调整输出窗口注意事项

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

要求

标头

 Ksmedia.h