KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION
KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION 是用來控制驅動程式背景模糊的屬性識別碼。
此屬性可控制驅動程式可執行檔串流內更正，以啟用高品質影像校正，以搭配預覽和錄製的影像使用。 串流內更正必須以統一的方式在驅動程式中啟用和停用，讓功能可由 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 | 這是選擇性的功能。 指定時，驅動程式中會啟用背景遮罩中繼資料生產 (，如果可能的話，前提是 MediaType 會透過KSCAMERA_EXTENDEDPROP_HEADER) 的 Size 欄位中傳回的一組KSPROPERTY_CAMERACONTROL_EXTENDED_ BACKGROUNDSEGMENTATION_CONFIGCAPS來表示。 請注意，這不只支援色彩相機，也可以支援深度和 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 結構欄位的描述和需求。
| member | 描述 |
|---|---|
| 版本 | 這必須是 1。 |
| PinId | 這必須 KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) 。 |
| 大小 | 這必須是 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) 。 |
| 結果 | 未使用，必須是 0。 |
| 功能 | 必須是上面定義的支援 KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION _* 旗標的位 OR。 |
| Flags | 這是讀取/寫入欄位。 這可以是上面定義的 任何一個KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION _* 旗標，但 (必須與 BLUR 一起設定，才能生效) 或位的有效組合。 從 SET 的觀點來看，只有在同時設定 SHALLOWFOCUS 和 BLUR 時，才會啟用淺層焦點模式，這些模式可以與 MASK 一起設定。 |
規格需求
最低支援的用戶端：Windows 11版本 22H2
標頭： ksmedia.h (包含 Ksmedia.h)
另請參閱
KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION