KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW

發行項
06/15/2023

KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW 是屬性識別碼，指定相機串流時相機的檢視和縮放欄位。

此控制項可能是平移、傾斜和縮放的替代專案。此控制項僅適用于相機主動串流時。若要主動串流處理，表示預覽或記錄釘選必須位於 KSSTATE_RUN中，且能夠傳遞畫面。

在 SET 上，如果資料流程不是使用中，此控制項會 傳回STATUS_INVALID_DEVICE_STATE。

您可以在 GitHub 上的 AVStream 數位相機範例驅動程式中找到設定 KSPROPERTY 控制項的範例。

使用量摘要資料表

範圍	控制	類型
第 1 版	篩選	同步

下列位旗標可控制驅動程式中的屬性識別碼：

#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL             0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING    0x0000000000000001

功能描述

下列旗標可以放在 KSCAMERA_EXTENDEDPROP_HEADER中。旗標 和 KSCAMERA_EXTENDEDPROP_HEADER。功能 欄位。

旗標	描述
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL	數位視窗是由應用程式手動控制。
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING	相機會自動調整數位視窗，將焦點放在檢視中的主要臉部。

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW 一律是同步控制項。

下表包含使用中繼資料控制項時 KSCAMERA_EXTENDEDPROP_HEADER 結構欄位的需求。

member	描述
版本	必須是 1。
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
大小	必須是 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING)
結果	必須包含 0。此欄位僅用於傳回最後一個非同步 SET 作業的結果。
功能	必須支援KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL。可以選擇性地支援KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING。
Flags	必須是KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL或KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING。

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING

如果在 [旗標] 欄位中設定KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING，則這些參數是唯讀的。如果在 SET 作業期間設定KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING，則會忽略下列參數。

參數	描述
OriginX	以 Q24 格式沿著 X 軸的數位視窗原點。必須預設為 0。 OriginX 可能不小於 PorchLeft 或大於 PorchRight – WindowSize。
OriginY	以 Q24 格式沿著 X 軸的數位視窗原點。必須預設為 0。 OriginX 可能不小於 PorchLeft 或大於 PorchRight – WindowSize。
WindowSize	以 Q24 格式沿著兩個軸的數位視窗大小。這是沿著 x 和 y 軸可見的完整檢視分數。 WindowSize 在 Q24) 中必須預設為 0x01000000 (1.0。 WindowSize 不可以小於 MinWindowSize 或大於 MaxWindowSize。此外，WindowSize 加上 OriginX 可能不大於 PorchRight;WindowsSize 加上 OriginY 可能不大於 PorchBottom。
保留	設定為 0。