通过

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE

  • 项目

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE 是用于打开和关闭人脸身份验证的属性 ID。

使用情况摘要表

范围 控制 类型

版本 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。

如果除了Windows Hello外，IR 相机还预期适用于常规方案，则应播发KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED。

用于人脸登录的 IR 摄像头应支持 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION 或 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION 功能，它们应仅支持这两种标志中的一个。

下表包含使用 控件时 KSCAMERA_EXTENDEDPROP_HEADER 结构字段的说明和要求。

成员 说明

版本

这必须为 1。

PinId

必须仅在筛选器上的一个引脚上播发。 引脚必须是 PINNAME_VIDEO_CAPTURE 或 PINNAME_VIDEO_PREVIEW类型，必须生成 IR 传感器数据，并且标记为 FrameServer 可共享。

大小

此 大小 必须为 (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) 。

结果

指示上次 SET 操作的错误结果。 如果未发生 SET 操作，则必须为 0。

功能

必须是上面定义的受支持 KSCAMERA_EXTENDEDPROP_ FACEAUTH_MODE_xxx 标志的按位或。

驱动程序不应同时播发 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION 和 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION

Flags

这是一个读/写字段。 这可以是上面定义的 任意一个KSCAMERA_EXTENDEDPROP_ FACEAUTH_MODE_xxx 标志。

要求

标头

 Ksmedia.h