共用方式為

KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION

  • 發行項

KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION是用來控制駕駛員眼球注視校正的屬性標識碼。

此屬性識別碼會控制驅動程式可執行的串流更正，以啟用高品質的影像更正，以搭配預覽和錄製的影像使用。 串流更正必須以統一的方式在驅動程式中啟用和停用，讓功能由 Windows 或應用程式控制。

您可以在 GitHub 上的 AVStream 相機 範例驅動程式中找到設定 KSPROPERTY 控制件的範例。

更新至KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION控件

從 Windows 11 版本 22H2 開始，Stare 模式會引進現有的眼球注視校正控件作為選擇性功能。

KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE是新增至KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION控件的新旗標，用來控制驅動程式上的Stare模式。

雖然眼球注視校正（也稱為眼部接觸）解決了相機顯示器位移的幾何問題，但許多視訊案例需要用戶長時間向下查看螢幕，同時說話 – 想像在通話中閱讀簡報/檔。

Stare 模式是一種更激進的眼部接觸形式，它不斷轉移眼睛的圖元，使其看起來像你正在與觀眾交談，即使你可能正在閱讀腳本，並迅速移動眼球。

使用量摘要數據表

範圍 控制 類型
第 1 版 篩選器 同步

下列旗標可以放在KSCAMERA_EXTENDEDPROP_HEADER中 。用來控制 Stare 模式的旗標 欄位。 預設值應該是 Off。

#define KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF   0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON    0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE 0x0000000000000002

如果驅動程式支援此控制件，它必須支援EYEGAZECORRECTION_OFF和一或多個其他旗標。

如果驅動程式不支援眼球注視校正，則驅動程式不應該實作此控件。

即使視訊或相片釘選處於KSSTATE_RUN狀態，此控件的SET呼叫仍會生效。 在 GET 呼叫中，驅動程式應該會傳回 [旗標] 字段中的目前設定。

下表描述旗標功能。

旗標 描述
KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF 這是必要功能。 指定時，會在驅動程式中停用眼球注視校正。
KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON 這是必要功能。 指定時，會在驅動程式中啟用眼球注視校正。
KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE 這是選擇性的功能。 與KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON一起指定時，會在驅動程式中啟用 Stare 模式。

注意

從 SET 的觀點來看，只有在同時設定KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE和KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON時，才會啟用 Stare 模式。 KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF必須是其他兩個位的獨佔。

下表包含使用控件時KSCAMERA_EXTENDEDPROP_HEADER結構欄位的描述和需求。

member 描述
版本 這必須是 1。
PinId 這必須是 KSCAMERA_EXTENDEDPROP_FILTERSCOPE （0xFFFFFFFF）。
大小 這必須是sizeof（KSCAMERA_EXTENDEDPROP_HEADER） + sizeof（KSCAMERA_EXTENDEDPROP_VALUE）。
結果 未使用，必須是 0。
功能 必須是上面所定義KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_* 旗標的位 OR。
旗標 這是讀取/寫入欄位。 這可以是上面定義的任一KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_* 旗標，但KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE除外（必須設定為 ON 才能生效），或位的有效組合。 從 SET 的觀點來看，只有在同時設定KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE和KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON時，才會啟用 Stare 模式。 KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF必須是其他 2 位的獨佔。

需求

最低支援的用戶端： Windows 11 版本 22H2

標頭： ksmedia.h （包括 Ksmedia.h）

另請參閱

背景分割直向模式和眼睛注視模式驅動程式範例

KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION

KSCAMERA_EXTENDEDPROP_HEADER