Поделиться через

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE

  • Статья

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE — это идентификатор свойства, который используется для включения и отключения проверки подлинности лицом.

Сводная таблица использования

Область Control Тип

версия 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

В следующей таблице описаны возможности флагов:

Flag Описание

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.

По умолчанию драйвер должен иметь KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE значение KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED , если это камера ir общего назначения. В противном случае ему следует задать значение KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION или KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION.

Камеры IR должны объявлять KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED, если они должны работать в общих сценариях, помимо Windows Hello.

Камеры 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.

Размер

Это должно быть значение sizeof(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

Флаги

Это поле для чтения и записи. Это может быть любой из указанных выше флагов KSCAMERA_EXTENDEDPROP_ FACEAUTH_MODE_xxx .

Требования

Заголовок

 Ksmedia.h