KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE 是用來開啟和關閉臉部驗證的屬性標識碼。

使用量摘要表格

範圍	控制	類型
第 1 版	Pin	同步

下列位旗標控制驅動程式中的臉部驗證：

#define KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED                        0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION  0x0000000000000002
#define KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION          0x0000000000000004

下表描述旗標功能：

旗標	描述
KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED	選擇性功能。 指定時，驅動程式會停用視訊臉部驗證模式。 此旗標與 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION 和 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION 旗標互斥。
KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION	不支援 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION 時的必要功能。 指定時，您必須在每個範例上設定 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION ，如框架元數據所述。 此旗標與 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION 和 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED 旗標互斥。 在此模式中，每個擷取的畫面應該要開啟/關閉IR簡介。
KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION	如果不支援 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION ，則為強制功能。 此旗標與 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION 和 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED 旗標互斥。 在此模式中，預期會建立背景環境 IR 光線減去的 IR 映射。

根據預設，如果驅動程式是一般用途 IR 相機，則應該 KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE 設定為 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED 。 否則，它應該設定為 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION 或 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION。

IR 相機在預期適用於一般案例時，除了 Windows Hello 之外，應該公告KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED。

用於臉部登入的 IR 相機應該支援 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION 或 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION 功能，它們只支援這兩個旗標的其中一個。

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

member	描述
版本	這必須是 1。
PinId	篩選上只能公告一個針腳。 針腳必須是類型 PINNAME_VIDEO_CAPTURE 或 PINNAME_VIDEO_PREVIEW、必須產生 IR 感測器數據，並標示為 FrameServer 可共用。
大小	這必須是 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) 。
結果	指出最後一個SET作業的錯誤結果。 如果未執行 SET 作業，這必須是 0。
功能	必須是上述所定義 之支援的KSCAMERA_EXTENDEDPROP_ FACEAUTH_MODE_xxx 旗標的位 OR。 驅動程式不應該同時公告 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION 和 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION
Flags	這是讀取/寫入欄位。 這可以是上述 任何一個KSCAMERA_EXTENDEDPROP_ FACEAUTH_MODE_xxx 旗標。

規格需求

標頭

Ksmedia.h