KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE
흰색 균형 모드 속성은 흰색 균형에 대해 자동 처리가 발생하는지 아니면 수동 온도 값을 대신 사용할지 여부를 지정합니다.
사용 요약 테이블
| Get | 설정 | 대상 | 속성 설명자 형식 | 속성 값 형식 |
|---|---|---|---|---|
| 예 | 네 | 필터 | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
속성 값(작업 데이터)에는 KSCAMERA_EXTENDEDPROP_HEADER 구조체와 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 구조체가 포함됩니다.
총 속성 데이터 크기는 sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING)입니다. KSCAMERA_EXTENDEDPROP_HEADER Size 멤버는 이 총 속성 데이터 크기로 설정됩니다.
KSCAMERA_EXTENDEDPROP_HEADER 기능 멤버에는 다음 비디오 처리 옵션 중 하나 이상의 비트 OR 조합이 포함되어 있습니다.
| 처리 모드 | 설명 |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO | 카메라 드라이버는 비디오에 자체 처리 논리를 사용합니다. |
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL | 카메라 드라이버는 미리 설정된 처리 방법 또는 온도 기반 메서드를 사용합니다. |
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK | 현재 비디오 처리 방법이 잠겨 있습니다. |
KSCAMERA_EXTENDEDPROP_HEADER Flags 멤버에는 현재 카메라에 대해 설정된 비디오 처리 플래그가 포함되어 있습니다. KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 설정은 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 함께 사용할 수 있습니다.
이 속성 컨트롤은 비동기이며 취소할 수 없습니다.
설명
처리 모드
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO
자동 처리가 지원됨을 나타냅니다. 드라이버는 내부 논리를 사용하여 비디오 처리를 최적화합니다. KSPROPERTY_TYPE_GET 요청의 경우 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING VideoProc 멤버는 비디오 처리에 대한 현재 드라이버 결정 값을 포함해야 합니다. 화이트 밸런스의 경우 켈빈의 현재 온도를 포함해야 합니다. 자동 작업에 대해 Mode 멤버가 무시됩니다.
이 플래그는 비트 OR 값으로 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 결합할 수 있습니다. 잠긴 경우 카메라 드라이버의 예상 동작은 흰색 균형을 수렴하고 흰색 균형 값을 수렴된 값으로 잠그는 것이며, 새 화이트 밸런스 명령을 받을 때까지 다시 자동 흰색 균형을 시도하지 않습니다.
자동 모드를 결합하지 않고 잠금은 이미 잠긴 컨트롤을 카메라 드라이버가 작동하지 않는 것으로 처리해야 합니다. 잠금은 자동 모드와 함께 이미 잠긴 컨트롤이 새 수렴을 트리거해야 합니다.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL
수동은 이 비디오 처리를 위해 특정 값이 제공됨을 나타냅니다. 흰색 균형의 경우 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 모드 멤버가 KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE 나타내는 경우 VideoProc.Value.ul에는 온도 값이 켈빈도로 포함됩니다.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 잠금 옵션 플래그는 현재 비디오 처리가 현재 프로그래밍된 값으로 잠겨 있음을 나타냅니다. 예를 들어 애플리케이션은 특정 화이트 밸런스가 결정될 때까지 자동 모드를 요청할 수 있습니다. 이때 애플리케이션은 동일한 흰색 균형 설정을 사용하여 사진 시퀀스를 모두 찍기로 결정합니다. 이러한 경우 애플리케이션은 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 플래그를 지정할 수 있습니다. 카메라 드라이버는 흰색 균형 정보가 다른 사진에서 변경되지 않도록 합니다.
속성 가져오기
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 OR'd(비디오 처리 모드 지원) |
| 플래그 | 현재 비디오 처리 모드입니다. |
이전에 화이트 밸런스 모드가 설정되지 않은 경우 드라이버는 플래그를 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO(기본값)로 설정합니다. KSCAMERA_EXTENDEDPROP_HEADER 따르는 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 구조체의 멤버는 처리 모드의 요구 사항에 따라 설정됩니다.
속성 설정
속성이 설정되면 KSPROPERTY_TYPE_SET 요청인 KSCAMERA_EXTENDEDPROP_HEADER Flags 멤버에 설정할 화이트 밸런스 모드가 포함됩니다. 플래그에 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 모드 플래그가 포함된 경우 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING VideoProc.Value 멤버를 무시해야 합니다.
요구 사항
버전: Windows 8.1부터 사용 가능
헤더: ksmedia.h(Ksmedia.h 포함)