共用方式為

KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL

  • 發行項

KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY列舉中定義的KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL屬性標識碼，可用來取得或設定 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 個 RO) 暴露 (

  • KSCAMERA_EXTENDEDPROP_ROI_EXPOSURE (ROI 1)

  • KSCAMERA_EXTENDEDPROP_ROI_EXPOSURE (ROI 2)

下表包含使用擴充 ROI 控制件的 KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL 屬性時，KSCAMERA_EXTENDEDPROP_HEADER結構欄位的描述和需求。

member 描述

版本

這必須是 1，

PinId

這必須 KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) ，

大小

若為初始 GET 呼叫 (發生，) 這必須是 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER) 。 此外，驅動程式必須在控制標頭承載的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 (焦點) + sizeof (KSCAMERA_EXTENDEDPROP_EXPOSURE) * ROICount (曝光) + sizeof (KSCAMERA_EXTENDEDPROP_WHITEBALANCE) * ROICount (白平衡) 。

結果

這表示上次 SET 作業的錯誤結果。 如果未執行 SET 作業，這必須是 0。 值 0 表示未偵測到所有已設定 ISP 控制件的錯誤。

功能

這必須是 KSCAMERA_EXTENDEDPROP_CAPS_ASYNCONTROL 和 KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE的位 OR。

Flags

這是可擦寫的欄位，這可能是 SET 呼叫 KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATION 。 這必須是 0，才能進行 GET 呼叫。

可調整的輸出窗口考慮

傳送至相機的 3A ROI 座標會相對於相機的目前輸出視窗傳送。 如果因為使用 Zoom、Pan 或 Tilt 或Digital Window 之類的控件而修改了檢視欄位，則相機 (或實作數位視窗/PTZ 控件的元件) 負責將提供的座標對應回感測器的完整檢視範圍，並考慮目前的輸出視窗，以確保相機的 3A 演算法是以正確的位置為目標。 視檢視欄位的修改發生位置而定，座標對應可能需要雙向。 例如，如果相機使用 Windows 平臺 DMFT 進行臉部偵測，但檢視修改是在驅動程式鏈結平臺 DMFT 之後的元件中實作，則應用程式所提供的 ROI 坐標必須先對應回完整的檢視字段，再傳送到平臺 DMFT 中計算的 ROI 座標，才能對應到平臺 DMFT 中計算的已修改字段，然後再進行傳送至要求它們的應用程式。

規格需求

標頭

 Ksmedia.h