KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE
토치 모드는 낮은 조명 조건에서 카메라의 플래시를 사용하는 방법을 결정합니다. 자동 초점과 같은 작업에 충분한 빛을 허용하기 위해 플래시에서 더 낮은 강도의 광원을 지속적으로 제공합니다.
사용량 요약 테이블
| Get | Set | 대상 | 속성 설명자 형식 | 속성 값 형식 |
|---|---|---|---|---|
Yes |
Yes |
필터 |
속성 값(작업 데이터)에는 KSCAMERA_EXTENDEDPROP_HEADER 구조와 KSCAMERA_EXTENDEDPROP_VALUE 구조가 포함됩니다.
총 속성 데이터 크기는 sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)입니다. KSCAMERA_EXTENDEDPROP_HEADERSize 멤버는 이 총 속성 데이터 크기로 설정됩니다.
KSCAMERA_EXTENDEDPROP_HEADERCapability 멤버에는 드라이버에서 지원하는 다음 토치 모드 중 하나 이상의 비트 OR 조합이 포함되어 있습니다.
| 토치 모드 | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF | 토치라이트가 꺼져 있습니다. |
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON | 토치라이트는 기본 강도 수준에 있습니다. |
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER | 토치라이트는 특정 전원 수준에서 작동합니다. |
KSCAMERA_EXTENDEDPROP_HEADERFlags 멤버에는 현재 카메라에 대해 설정된 토치 모드가 포함되어 있습니다. 카메라의 기본 토치 모드는 KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF 드라이버가 이 토치 모드를 지원해야 합니다.
이 속성 컨트롤은 동기적이며 취소할 수 없습니다.
설명
속성 가져오기
KSPROPERTY_TYPE_GET 요청에 응답할 때 드라이버는 KSCAMERA_EXTENDEDPROP_HEADER 멤버를 다음으로 설정합니다.
| 멤버 | 값 |
|---|---|
| 버전 | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE(0xFFFFFFFF). |
| 크기 | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) |
| 결과 | 0 |
| 기능 | 토치 모드 값이 지원됩니다. |
| 플래그 | 현재 토치 모드 값 설정(값 하나만)입니다. |
토치 모드가 KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER 경우 KSCAMERA_EXTENDEDPROP_VALUEValue.ull 멤버에는 0~100 사이의 강도 수준 값이 포함됩니다. 강도 0은 최소 수준을 나타내고 강도는 100은 최대 강도 수준을 나타냅니다.
이전에 장면 모드가 설정되지 않은 경우 플래그 는 KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF(기본값)로 설정됩니다.
속성 설정
속성이 설정되면 KSPROPERTY_TYPE_SET 요청인 KSCAMERA_EXTENDEDPROP_HEADERFlags 멤버에 설정할 토치 모드가 포함됩니다. KSCAMERA_EXTENDEDPROP_VALUE Value.ull 멤버에는 Flags가 KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER 경우 설정할 강도 수준이 포함됩니다.
요구 사항
Version |
Windows 8.1 사용하여 사용할 수 있습니다. |
헤더 |
Ksmedia.h(Ksmedia.h 포함) |