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） |