KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2是屬性標識符，以度為單位指定相機對角線視野（FoV）。 對角線 FoV 值會對應至感測器原生外觀比例的對角線 FoV。 這會產生非原生外觀比例，其實際對角線 FoV 稍有不同。
此控件與 KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW、 KSPROPERTY_CAMERACONTROL_ZOOM和 KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM相關。 如需互操作性需求，請參閱下方的備註一節。
使用量摘要數據表
| 範圍 | 取得 Yammer | 設定 | 控制 | 類型 |
|---|---|---|---|---|
| 第 1 版 | Yes | .是 | 篩選器 | 同步 |
KSCAMERA_EXTENDEDPROP_HEADER結構欄位
下表包含使用控件時KSCAMERA_EXTENDEDPROP_HEADER結構欄位的需求。
| member | 描述 |
|---|---|
| 版本 | 必須是 1。 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE （0xFFFFFFFF） |
| 大小 | 必須是sizeof（KSCAMERA_EXTENDEDPROP_HEADER） + sizeof（KSCAMERA_EXTENDEDPROP_VALUE） |
| 結果 | 必須包含 0。 此欄位僅用於傳回最後一個異步 SET 作業的結果。 |
| 功能 | 必須是 0。 |
| 旗標 | 必須是 0。 |
KSCAMERA_EXTENDEDPROP_VALUE承載
承載會使用具有ULONG類型的現有 KSCAMERA_EXTENDEDPROP_VALUE 結構。
備註
與KSPROPERTY_CAMERACONTROL_ZOOM和KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM的互操作性
如果驅動程式/裝置選擇同時支援這個新的 FoV 控制件和舊的 KSPROPERTY_CAMERACONTROL_ZOOM 或 KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM，縮放控件必須在新的檢視欄位 （FoV） 選取範圍內運作。 這表示 Zoom 相對於 FoV。 對於FoV的不同值，相同的 Zoom 值會產生不同的明顯縮放量。 此外，設定FoV一律會將 Zoom 重設為其預設值，不論實際FoV值是否有變更。
例如，將舊的 Zoom 控制件範圍指定為從 10 到 600，而縮放則是其預設值 10，當新的 FoV 設定從 75 度設定為 90 度時，舊的縮放控件仍會位於 10，且範圍相同 10 到 600。 但是，如果舊的縮放比例為 50，則會在設定新的 FoV 值時重設為 10。
與KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW和DIGITALWINDOW_CONFIGCAPS的互操作性
如果驅動程式/裝置選擇同時支援這個新的 FoV2 控制件和數位視窗 （DW） 控制件，則必須遵循下列需求：
如果實作 Digital Window 支援的唯一目的是支援KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING，則手動數位視窗只支援代表完整視窗的一個視窗大小是可接受的。 此完整視窗應該符合FIELDOFVIEW2_CONFIGCAPS的 DefaultDiagonalFieldOfViewInDegrees，不過 FoV 的最大值可以更寬。 在此情況下，可以忽略下列手動數字視窗的需求，因為不支援手動數字視窗。
支援的手動數字視窗區域必須至少涵蓋最寬的 FoV 設定，例如，使用 Digital Window，您可以建立符合任何支援的 FoV 設定的數位裁剪。 如果預設 FoV 不是最寬的 FoV，數位視窗應該使用 Porch 值來代表較寬的視窗。
不論 FoV 控制件狀態為何，KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW_CONFIGCAPS都必須報告相同的功能。
目前的手動數字窗口必須反映目前的FoV設定，反之亦然，最後一個控件會獲勝。
設定手動數字視窗時，FoV 應該在內部變更為包含所選取視窗區域的最小可用 FoV 設定。 這表示數字視窗的原始座標即使數字視窗大小保持不變，也會在FoV中造成變更。 例如，如果數字視窗原點座標位於左上角，且有0.4個視窗大小，FoV 設定會公告最寬的可用FoV（在此範例中為120°），否則不會包含該區域。 但是，如果第二個具有相同視窗大小的數字視窗做為中心裁剪，反映的FoV可能是較窄的東西（在我們的範例中為75°75°） 。。
支援並設定KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING時，驅動程式/裝置必須在內部將FoV變更為最寬的設定。 例如，啟用KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING時，KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2的 GET 作業會傳回最寬的 FoV 設定。 不過，KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2的任何成功 SET 作業都會將數位視窗變更回KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL模式，因為最後一個控件獲勝。
與相關區域控制件的互操作性
由於此控件會變更明顯的檢視字段 （FoV），因此每當向此控件發出 SET 時，透過任何感興趣的區域 （ROI） 控制項選取的座標應該重設為預設值。 目前的 ROI 控制件清單包括：
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_PROPERTY_ID
KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_CONFIGCAPS/ KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL
如果我們定義定義矩形區域的未來控件，該控件也必須重設。
此外，利益區域控件會指定其相對於輸出視窗的區域，因此它們指定的座標一律是目前檢視欄位中的矩形。 由於此控件會變更目前的檢視欄位，因此相機必須重新對應感興趣的區域矩形，以符合目前的檢視字段。
需求
最低支援的用戶端： Windows 11 版本 24H2
標頭： ksmedia.h （包括 Ksmedia.h）