KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION

KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION 드라이버의 시선 응시 보정을 제어하는 데 사용되는 속성 ID입니다.

이 속성 ID는 드라이버가 미리 보기 및 녹화된 이미지와 함께 사용하기 위해 고품질 이미지 보정을 사용하도록 하기 위해 수행할 수 있는 스트림 내 수정을 제어합니다. Windows 또는 애플리케이션에서 기능을 제어할 수 있도록 드라이버에서 인스트림 보정을 균일한 방식으로 사용하도록 설정하고 사용하지 않도록 설정해야 합니다.

KSPROPERTY 컨트롤 설정의 예는 GitHub의 AVStream 카메라 샘플 드라이버에서 찾을 수 있습니다.

KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION 컨트롤로 업데이트

Windows 11 버전 22H2부터 응시 모드는 선택적 기능으로 기존 시선 응시 보정 컨트롤에 도입되었습니다.

KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE 드라이버의 응시 모드를 제어하는 데 사용되는 KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION 컨트롤에 추가된 새 플래그입니다.

시선 응시 보정(눈 접촉이라고도 함)은 카메라 디스플레이 오프셋의 기하학적 문제를 해결하지만, 많은 비디오 시나리오에서는 사용자가 통화에서 프레젠테이션/문서를 읽는 것을 상상하면서 장시간 화면을 내려다보도록 요구합니다.

응시 모드는 스크립트를 읽고 눈알을 빠르게 움직일 수 있더라도 청중과 대화하는 것처럼 보이도록 눈의 픽셀을 지속적으로 이동하는 더 공격적인 형태의 눈 접촉입니다.

사용량 요약 테이블

범위	컨트롤	Type
버전 1	필터	동기

KSCAMERA_EXTENDEDPROP_HEADER 다음 플래그를 배치할 수 있습니다. 응시 모드를 제어하는 플래그 필드입니다. 기본값은 Off여야 합니다.

#define KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF   0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON    0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE 0x0000000000000002

드라이버가 이 컨트롤을 지원하는 경우 EYEGAZECORRECTION_OFF 하나 이상의 다른 플래그를 지원해야 합니다.

드라이버가 시선 응시 보정을 지원하지 않는 경우 드라이버는 이 컨트롤을 구현하면 안 됩니다.

이 컨트롤의 SET 호출은 비디오 또는 사진 핀이 KSSTATE_RUN 상태인 경우에도 적용됩니다. GET 호출에서 드라이버는 Flags 필드에서 현재 설정을 반환해야 합니다.

다음 표에서는 플래그 기능에 대해 설명합니다.

Flag	설명
KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF	필수 기능입니다. 지정하면 드라이버에서 시선 응시 보정이 비활성화됩니다.
KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON	필수 기능입니다. 지정된 경우 드라이버에서 시선 응시 보정을 사용하도록 설정합니다.
KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE	선택적 기능입니다. KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON 함께 지정하면 드라이버에서 응시 모드가 활성화됩니다.

참고 항목

SET 관점에서 응시 모드는 KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE 및 KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON 동시에 설정된 경우에만 사용하도록 설정됩니다. KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF 다른 두 비트에만 사용해야 합니다.

아래 표에는 컨트롤을 사용할 때 KSCAMERA_EXTENDEDPROP_HEADER 구조 필드에 대한 설명과 요구 사항이 포함되어 있습니다.

멤버	설명
버전	1이어야 합니다.
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE(0xFFFFFFFF)이어야 합니다.
크기	sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)여야 합니다.
결과	사용하지 않는 경우 0이어야 합니다.
기능	위에서 정의한 지원되는 KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_* 플래그의 비트 OR이어야 합니다.
플래그	읽기/쓰기 필드입니다. KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE(적용하려면 ON과 함께 설정해야 하는 경우) 또는 비트의 유효한 조합을 제외하고 위에서 정의한 KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ * 플래그 중 하나일 수 있습니다. SET 관점에서 응시 모드는 KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE 및 KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON 동시에 설정된 경우에만 활성화됩니다. KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF 다른 2비트만 사용해야 합니다.

요구 사항

지원되는 최소 클라이언트: Windows 11, 버전 22H2

헤더: ksmedia.h(Ksmedia.h 포함)

참고 항목

배경 구분 세로 모드 및 시선 응시 모드 드라이버 샘플

KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION

KSCAMERA_EXTENDEDPROP_HEADER