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 和两个曝光 RO 的数据结构布局。
KSCAMERA_EXTENDEDPROP_HEADER
KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER
KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL （焦点）
KSCAMERA_EXTENDEDPROP_ROI_FOCUS
KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL （使用 2 个 ROIs 曝光）
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 调用），这必须是 sizeof（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（focus） + sizeof（KSCAMERA_EXTENDEDPROP_EXPOSURE） * ROICount（曝光） + sizeof（KSCAMERA_EXTENDEDPROP_WHITEBALANCE） * ROICount（whitebalance）。 |
结果 |
这表示上次 SET作的错误结果。 如果未执行 SET作，则必须为 0。 值 0 指示所有配置的 ISP 控件均未检测到任何错误。 |
能力 |
这必须是按位或 KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL 和 KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE。 |
标志 |
这是一个读/写字段，这可能是 SET 调用的 KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATION。 对于 GET 调用，这必须为 0。 |
可调整输出窗口注意事项
发送到相机的 3A ROI 坐标相对于相机的当前输出窗口发送。 如果由于使用 缩放、平移或倾斜 或 数字窗口等控件而修改了视图字段，则相机（或实现数字窗口/PTZ 控件的组件）负责将提供的坐标映射回传感器的完整视野，考虑当前输出窗口以确保相机的 3A 算法面向正确的位置。 根据视图修改字段的发生位置，坐标映射可能需要双向。 例如，如果相机使用 Windows 平台 DMFT 进行人脸检测，但在驱动程序链中的平台 DMFT 之后的组件中实现了视图修改，则应用程序提供的 ROI 坐标需要映射回整个视野，然后再将平台 DMFT 中计算的 ROI 坐标映射到修改后的视野，然后才能被映射到修改后的视野发送到请求它们的应用。
要求
页眉 |
Ksmedia.h |