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）