KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE
포커스 모드 속성은 카메라의 자동, 수동 및 미리 설정된 포커스 모드를 제어합니다.
사용 요약 테이블
| Get | Set | 대상 | 속성 설명자 형식 | 속성 값 형식 |
|---|---|---|---|---|
Yes |
Yes |
필터 |
속성 값(작업 데이터)에는 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 포함) |