KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE

포커스 모드 속성은 카메라의 자동, 수동 및 미리 설정된 포커스 모드를 제어합니다.

사용 요약 테이블

Get	Set	대상	속성 설명자 형식	속성 값 형식
Yes	Yes	필터	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

속성 값(작업 데이터)에는 KSCAMERA_EXTENDEDPROP_HEADER 구조체와 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 구조체가 포함됩니다.

총 속성 데이터 크기는 sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING)입니다. KSCAMERA_EXTENDEDPROP_HEADERSize 멤버는 이 총 속성 데이터 크기로 설정됩니다.

KSCAMERA_EXTENDEDPROP_HEADERCapability 멤버에는 다음 비디오 처리 옵션 중 하나 이상의 비트 OR 조합이 포함되어 있습니다.

처리 및 포커스 모드	Description
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO	카메라 드라이버는 비디오에 자체 처리 논리를 사용합니다.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL	카메라 드라이버는 미리 설정된 처리 방법 또는 온도 기반 방법을 사용합니다.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK	현재 비디오 처리 방법이 잠겨 있습니다.
KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS	수렴 초점 집합이 없습니다.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_MACRO	매크로 범위 초점 수렴.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_NORMAL	표준 범위 초점 수렴.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE	전체 범위 초점 수렴.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_INFINITY	무한 범위 초점 수렴.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_HYPERFOCAL	하이퍼포컬 범위입니다.

KSCAMERA_EXTENDEDPROP_HEADERFlags 멤버에는 현재 카메라에 대해 설정된 비디오 처리 플래그가 포함되어 있습니다. KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 설정이 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 결합될 수 있는 경우

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

설명

처리 모드

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO

이 플래그는 완료 이벤트가 트리거될 때 자동 포커스 작업이 수렴되었음을 나타냅니다. 완료되면 이 플래그가 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 결합되지 않으면 포커스가 갈라지고 카메라 드라이버가 계속 수렴을 시도할 수 있습니다. KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 플래그가 포함된 경우 포커스가 첫 번째 수렴에 잠기고 새 포커스 명령이 수신될 때까지 변경되지 않습니다.

자동 모드를 결합하지 않고 잠금은 이미 잠긴 컨트롤을 카메라 드라이버에서 no-op으로 처리해야 합니다. 잠금은 자동 모드와 함께 이미 잠긴 컨트롤이 새 수렴을 트리거해야 합니다.

이 플래그는 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL 및 KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS 플래그와 함께 사용할 수 없습니다.

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL

수동은 이 비디오 처리에 대해 특정 값이 제공됨을 나타냅니다. 드라이버에 특정 값이 제공됩니다.

이 플래그는 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 또는 KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS 결합해서는 안 됩니다.

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK

해당 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 플래그 없이 이 플래그를 설정하면 카메라 드라이버는 현재 포커스 상태를 잠그고 포커스가 잠기면 완료 이벤트를 트리거해야 합니다. 카메라 드라이버는 새 포커스 명령을 받을 때까지 포커스 상태를 변경해서는 안됩니다. KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 이 플래그를 결합한 경우 카메라 드라이버는 자동 포커스를 수렴하고 해당 수렴 지점에 포커스를 잠가서 완료 이벤트를 트리거합니다. 이 플래그는 KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS 또는 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL 함께 사용하면 안 됩니다.

이 플래그는 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 결합하지 않는 한 포커스 컨트롤에 대한 범위 플래그로 지정할 수 없습니다. 이 경우 범위 플래그를 사용하여 포커스를 수행하여 자동 포커스 검사를 시도할 위치를 결정합니다. 그런 다음, 수렴 시 포커스 설정이 잠기고 완료 이벤트가 발생합니다.

KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS

이 플래그는 포커스가 연속됨을 나타냅니다. 이 경우 포커스 제어에 대한 단일 수렴 지점이 없습니다. 드라이버는 이 요청을 수락하고 비동기 작업을 즉시 완료해야 합니다.

이 플래그는 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 또는 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL 결합해서는 안 됩니다.

이 모드는 모든 드라이버에 필요합니다.

KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_MACRO

이 플래그는 매크로 범위에 대해 포커스 수렴을 수행해야 함을 나타냅니다. 정확한 초점 범위는 드라이버에 의해 결정됩니다. 이 플래그는 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 및 KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS 결합할 수 있습니다.

KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_NORMAL

이 플래그는 정상 범위에 대해 포커스 수렴을 수행해야 함을 나타냅니다. 정확한 초점 범위는 드라이버에 의해 결정됩니다. 이 플래그는 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 및 KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS 결합할 수 있습니다.

KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE

이 플래그는 전체 범위에 대해 포커스 수렴을 수행해야 함을 나타냅니다. 정확한 초점 범위는 드라이버에 의해 결정됩니다. 이 플래그는 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 및 KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS 결합할 수 있습니다.

이 모드는 모든 드라이버에 필요합니다.

KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_INFINITY

이 플래그는 무한 범위에 대해 포커스 수렴을 수행해야 함을 나타냅니다. 정확한 초점 범위는 드라이버에 의해 결정됩니다. 이 플래그는 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 및 KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS 결합할 수 있습니다.

KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_HYPERFOCAL

이 플래그는 하이퍼포컬 범위에 대해 포커스 수렴을 수행해야 함을 나타냅니다. 정확한 초점 범위는 드라이버에 의해 결정됩니다. 이 플래그는 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 및 KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS 결합할 수 있습니다.

속성 가져오기

KSPROPERTY_TYPE_GET 요청에 응답할 때 드라이버는 KSCAMERA_EXTENDEDPROP_HEADER 멤버를 다음으로 설정합니다.

멤버	값
버전	1
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE(0xFFFFFFFF).
크기	sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING)
결과	0
기능	KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE | (비디오 처리 및 포커스 모드 지원)
플래그	현재 비디오 처리 및 포커스 모드입니다.

이전에 설정된 포커스 범위 플래그가 없으면 드라이버는 플래그 를 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO(기본값)과 함께 KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE 설정합니다. KSCAMERA_EXTENDEDPROP_HEADER 따르는 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 구조체의 멤버는 포커스 모드의 요구 사항에 따라 설정됩니다.

VideoProp.Value.ull 값은 모드가 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 때 현재 노출 설정을 포함해야 합니다.

속성 설정

속성이 설정되면 KSPROPERTY_TYPE_SET 요청인 KSCAMERA_EXTENDEDPROP_HEADERFlags 멤버에 설정할 포커스 모드가 포함됩니다. Flags에 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS플래그가 포함된 경우 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING VideoProc.Value 멤버를 무시해야 합니다.

요구 사항

Version	Windows 8.1 시작해서 사용할 수 있습니다.
헤더	Ksmedia.h(Ksmedia.h 포함)

추가 정보

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING