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 |