KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK結構 （ksmedia.h）
KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK 結構包含背景遮罩維度及其所推斷框架涵蓋範圍的相關信息，這是數據流所輸出的框架。
語法
typedef struct tagKSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK {
KSCAMERA_METADATA_ITEMHEADER Header;
RECT MaskCoverageBoundingBox;
SIZE MaskResolution;
RECT ForegroundBoundingBox;
BYTE MaskData[1];
} KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK, *PKSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK;
成員
Header
KSCAMERA_METADATA_ITEMHEADER 結構，其中包含相機驅動程式所填入的元數據標頭資訊。
MaskCoverageBoundingBox
原始影像座標中已處理遮罩區域的周框方塊。
如果驅動程式可以提供涵蓋整個檢視欄位的遮罩，則此周框方塊應與它對應的框架相同。
MaskResolution
此結構中連續 MaskData 緩衝區中包含的遮罩數據寬度和高度。
這應該對應至由 KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION屬性之 GET 傳回之相關 KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS 的 MaskResolution 成員。
ForegroundBoundingBox
遮罩座標中所有前景圖元的周框方塊。
這可能有助於加速應用程式處理，只考慮遮罩的一部分。 如果驅動程式未計算，則可以保留此內容以涵蓋整個遮罩。 不過，若未涵蓋整個遮罩，則不論其實際值為何，此周框方塊外部的遮罩數據都應該視為背景（零） 值。
MaskData[1]
MaskResolution.cx * MaskResolution.cy BYTE 值會填入為連續緩衝區。
值代表圖元為背景或前景一部分的標準化信賴分數，其中值 「0」 指定背景圖元的 100% 確定性，而 「255」 指定 100 個% 前景圖元的確定性。
超過 MaskData 欄位的緩衝區大小，大小取決於 MetadataSize 欄位的大小。 MetadataSize 應等於 FIELD_OFFSET（KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK，MaskData） + [MaskResolution.cx * MaskResolution.cy]。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 11 |
| 標頭 | ksmedia.h （包括 Ksmedia.h） |