KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION
KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION 是一个属性 ID，用于控制驱动程序上的背景模糊。
此属性控制驱动程序可以执行的流内更正，以启用与预览和录制图像一起使用的高质量图像更正。 需要在驱动程序中以统一方式启用和禁用流内更正，以便这些功能可由 Windows 或应用程序控制。
可以在 GitHub 上的 AVStream 相机示例驱动程序 中找到设置 KSPROPERTY 控件的示例。
更新到KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION控件
从 Windows 11 版本 22H2 开始，浅色焦点模式已作为可选功能引入现有背景分段控件。
KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_SHALLOWFOCUS 是添加到KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION控件的新标志，用于控制驱动程序上的 Bokeh (浅焦点模式) 。 这是背景模糊 KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION的一个版本，其中强调的不是隐私，而更多的是使用户的背景看起来像更高质量的相机与景深效果。 这在视觉上将使前景主题脱颖而出，类似于许多手机上的人像模式摄影变得流行。
使用情况摘要表
| 范围 | 控制 | 类型 |
|---|---|---|
| 版本 1 | 筛选器 | 同步 |
以下标志可以放在 KSCAMERA_EXTENDEDPROP_HEADER中。用于 控制浅焦点模式的标志字段。
#define KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_OFF 0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_BLUR 0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_MASK 0x0000000000000002
#define KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_SHALLOWFOCUS 0x0000000000000004
如果驱动程序支持此控件，则它必须支持BACKGROUNDSEMENTATION_OFF和一个或多个其他标志。
如果驱动程序不支持后台分段，则驱动程序不应实现此控件。
即使视频或照片引脚处于KSSTATE_RUN状态，此控件的 SET 调用也应生效。 在 GET 调用中，驱动程序应在“标志”字段中返回当前设置。
下表描述了标志功能。
| 标志 | 描述 |
|---|---|
| KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_OFF | 这是一项必需的功能。 指定后，在驱动程序中禁用后台分段。 这是默认值。 |
| KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_BLUR | 这是一项可选功能。 指定后，背景模糊在驱动程序中启用，并应用于帧（如果可能）。 |
| KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_MASK | 这是一项可选功能。 指定后，如果可能，在驱动程序 (启用背景掩码元数据生成，前提是使用通过KSCAMERA_EXTENDEDPROP_HEADER) 的“大小” 字段中返回的一组KSPROPERTY_CAMERACONTROL_EXTENDED_ BACKGROUNDSEGMENTATION_CONFIGCAPS表示的 MediaType。 请注意，这不仅支持彩色相机，还支持深度和 IR 相机。 |
| KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_SHALLOWFOCUS | 这是一项可选功能。 与 KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_BLUR 一起指定时，在驱动程序中启用浅焦点。 |
注意
从 SET 的角度来看， 需要添加KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_SHALLOWFOCUS 以及 KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_BLUR 才能生效：还可以与 KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_MASK一起设置它们。
下表包含使用 控件时 KSCAMERA_EXTENDEDPROP_HEADER 结构字段的说明和要求。
| 成员 | 说明 |
|---|---|
| 版本 | 此值必须为 1。 |
| PinId | 这必须 KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) 。 |
| 大小 | 这必须是 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) 。 |
| 结果 | 未使用，必须为 0。 |
| 功能 | 必须是上面定义的受支持 KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION _* 标志的按位 OR。 |
| Flags | 这是一个读/写字段。 这可以是上面定义的KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION _* 标志之一，但需要与 BLUR 一起设置才能) 或有效位组合的 SHALLOWFOCUS (除外。 从 SET 的角度来看，仅当同时设置 SHALLOWFOCUS 和 BLUR 时，才会启用浅色对焦模式，这些模式可与 MASK 一起设置。 |
要求
支持的最低客户端：Windows 11版本 22H2
标头： ksmedia.h (包括 Ksmedia.h)
另请参阅
KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION