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 카메라인 경우 KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE 설정해야 합니다. 그렇지 않으면 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 구조 필드에 대한 설명과 요구 사항이 포함되어 있습니다.

멤버 Description

버전

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