다음을 통해 공유

KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM

  • 아티클

KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM 디지털 확대/축소를 제어하는 데 사용됩니다. KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY 열거형에 정의되며 확대/축소 비율을 가져와서 설정하고 드라이버에서 확대/축소 범위를 가져오는 데 사용됩니다. Windows 10 이 컨트롤은 부드러운 확대/축소도 지원하도록 확장됩니다.

사용량 요약 테이블

범위 컨트롤 형식

버전 1

필터

동기

KSCAMERA_EXTENDEDPROP_HEADER 다음 플래그를 배치할 수 있습니다 . 부드러운 확대/축소와 직접 확대/축소를 제어하는 플래그 필드입니다. 기본값은 드라이버에 의해 정의됩니다.

#define KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT  0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_ZOOM_DIRECT   0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_ZOOM_SMOOTH   0x0000000000000002

드라이버가 이 컨트롤을 지원하는 경우 KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT 지원해야 합니다.

드라이버가 디지털 확대/축소를 지원하지 않는 경우 드라이버는 이 컨트롤을 구현해서는 안 됩니다.

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

플래그 설명

KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT

이는 필수 기능입니다. 지정된 경우 드라이버는 직접 확대/축소 또는 부드러운 확대/축소를 적용할지 여부를 결정하고 이에 따라 VideoProc.Value.ul에 지정된 대상 확대/축소 요소를 확대/축소합니다. 이 플래그는 DIRECT 및 SMOOTH 플래그와 함께 사용할 수 없습니다.

KSCAMERA_EXTENDEDPROP_ZOOM_DIRECT

이는 필수 기능입니다. 지정하면 드라이버는 VideoProc.Value.ul에 지정된 대상 확대/축소 요소를 최대한 빨리 확대/축소합니다. 이 플래그는 AUTO 및 SMOOTH 플래그와 함께 사용할 수 없습니다.

KSCAMERA_EXTENDEDPROP_ZOOM_SMOOTH

이 기능은 선택 사항입니다. 지정된 경우 드라이버는 VideoProc.Value.ul에 지정된 대상 확대/축소 인수를 부드럽게 점진적으로 확대/축소합니다. 지정된 확대/축소 계수에 도달하는 데 걸리는 프레임 수는 드라이버에 달려 있습니다. 이 플래그는 AUTO 및 DIRECT 플래그와 함께 사용할 수 없습니다.

각 GET 호출에 대해 드라이버는 현재 구성 또는 설정에 따라 허용되는 현재 확대/축소 범위를 보고해야 합니다.

다음 표에는 KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM 속성을 사용할 때 KSCAMERA_EXTENDEDPROP_HEADER 구조 필드에 대한 설명과 요구 사항이 포함되어 있습니다.

멤버 Description

버전

1이어야 합니다.

PinId

KSCAMERA_EXTENDEDPROP_FILTERSCOPE(0xFFFFFFFF)이어야 합니다.

크기

sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING)여야 합니다.

결과

이는 마지막 SET 작업의 오류 결과를 나타냅니다. SET 작업이 수행되지 않은 경우 0이어야 합니다.

기능

위에서 정의한 지원되는 플래그의 비트 OR이어야 합니다.

플래그

읽기/쓰기 필드입니다. 위에서 정의한 지원되는 플래그 중 하나일 수 있습니다.

아래 표에는 KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM 속성에 대한 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 구조 필드에 대한 설명과 요구 사항이 포함되어 있습니다.

멤버 Description

Mode

사용되지 않으며 0이어야 합니다.

최소/최대/단계

최소/최대/단계에는 카메라 드라이버에서 지원하는 확대/축소 비율의 최소/최대/증가가 Q16 형식으로 포함되어 있습니다. 드라이버는 GET 작업에 대해 이러한 값을 반환해야 합니다.

VideoProc

SET 작업의 경우 VideoProc.Value.ul은 Min/Max/Step 매개 변수에 설명된 범위 내에서 확대/축소 비율을 지정해야 합니다. GET 작업의 경우 드라이버는 현재 확대/축소 비율을 반환해야 합니다.

예약됨

사용되지 않습니다. 드라이버에서 무시해야 합니다.

이 속성 컨트롤은 동기적이며 취소할 수 없습니다.

요구 사항

헤더

 Ksmedia.h