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

KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS

KSCAMERA_EXTENDEDPROP_HEADER