KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW

아티클
06/15/2023

KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW 카메라가 스트리밍되는 동안 카메라의 보기 및 확대/축소 필드를 지정하는 속성 ID입니다.

이 컨트롤은 팬, 기울기 및 확대/축소를 대체할 수 있습니다. 이 컨트롤은 카메라가 적극적으로 스트리밍되는 동안에만 적용됩니다. 적극적으로 스트리밍하려면 미리 보기 또는 레코드 핀이 KSSTATE_RUN 프레임을 제공할 준비가 되어 있어야 합니다.

SET에서 스트림이 활성화되지 않은 경우 이 컨트롤은 STATUS_INVALID_DEVICE_STATE 반환합니다.

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

사용량 요약 테이블

Scope	컨트롤	형식
버전 1	필터	동기

다음 비트 플래그는 드라이버의 속성 ID를 제어합니다.

#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL             0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING    0x0000000000000001

기능 설명

KSCAMERA_EXTENDEDPROP_HEADER 다음 플래그를 배치할 수 있습니다 . 플래그 및 KSCAMERA_EXTENDEDPROP_HEADER. 기능 필드.

플래그	설명
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL	디지털 창은 애플리케이션에서 수동으로 제어합니다.
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING	카메라는 자동으로 디지털 창을 조정하여 보기에서 지배적 인 얼굴에 초점을 맞춥니다.

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW 항상 동기 컨트롤입니다.

다음 표에는 메타데이터 컨트롤을 사용할 때 KSCAMERA_EXTENDEDPROP_HEADER 구조 필드에 대한 요구 사항이 포함되어 있습니다.

멤버	Description
버전	1이어야 합니다.
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE(0xFFFFFFFF)
크기	sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+ sizeof(KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING)여야 합니다.
결과	0을 포함해야 합니다. 이 필드는 마지막 비동기 SET 작업의 결과를 반환하는 데만 사용됩니다.
기능	KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL 지원해야 합니다. 필요에 따라 KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING 지원할 수 있습니다.
플래그	KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL 또는 KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING 합니다.

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING

이러한 매개 변수는 플래그 필드에 KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING 설정된 경우 읽기 전용입니다. SET 작업 중에 KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING 설정되면 다음 매개 변수가 무시됩니다.

매개 변수	Description
OriginX	Q24 형식의 X축을 따라 디지털 창의 원본입니다. 기본값은 0이어야 합니다. OriginX는 PorchLeft보다 작거나 PorchRight – WindowSize보다 크지 않을 수 있습니다.
Originy	Q24 형식의 X축을 따라 디지털 창의 원본입니다. 기본값은 0이어야 합니다. OriginX는 PorchLeft보다 작거나 PorchRight – WindowSize보다 크지 않을 수 있습니다.
WindowSize	Q24 형식의 두 축을 따라 디지털 창의 크기입니다. x축과 y축을 따라 표시되는 전체 보기의 비율입니다. WindowSize는 기본적으로 0x01000000(Q24의 경우 1.0)이어야 합니다. WindowSize는 MinWindowSize보다 작거나 MaxWindowSize보다 크지 않을 수 있습니다. 또한 WindowSize 및 OriginX는 PorchRight보다 크지 않을 수 있습니다. WindowsSize 및 OriginY는 PorchBottom보다 크지 않을 수 있습니다.
예약됨	0으로 설정합니다.