KSPROPERTY_CAMERACONTROL_EXTENDED_FLASHMODE(일반 및 시퀀스)
플래시 속성 컨트롤은 카메라의 일반 및 시퀀스 사진 모드 모두에 대한 플래시 모드 작업을 설정합니다.
사용량 요약 테이블
| Get | Set | 대상 | 속성 설명자 형식 | 속성 값 형식 |
|---|---|---|---|---|
| Yes | Yes | 필터 | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
속성 값(작업 데이터)에는 KSCAMERA_EXTENDEDPROP_HEADER 구조와 KSCAMERA_EXTENDEDPROP_VALUE 구조가 포함됩니다.
총 속성 데이터 크기는 sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)입니다. KSCAMERA_EXTENDEDPROP_HEADERSize 멤버는 이 총 속성 데이터 크기로 설정됩니다.
KSCAMERA_EXTENDEDPROP_HEADERCapability 멤버에는 드라이버에서 지원하는 다음 플래시 모드 중 하나 이상의 비트 OR 조합이 포함되어 있습니다.
| 플래시 모드 | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_FLASH_OFF | 플래시가 꺼져 있습니다. |
| KSCAMERA_EXTENDEDPROP_FLASH_ON | 플래시는 기본 강도 수준에서 켜집니다. |
| KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER | 플래시가 특정 전원 수준에서 켜집니다. |
| KSCAMERA_EXTENDEDPROP_FLASH_AUTO | 플래시는 조명 조건에 따라 자동으로 적용됩니다. |
| KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER | 플래시는 특정 전원 수준의 조명 조건에 따라 자동으로 작동합니다. |
다음 기능 플래그는 KSCAMERA_EXTENDEDPROP_FLASH_OFF 제외하고 이전 플래시 설정과 결합할 수 있습니다.
| 플래시 기능 | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_FLASH_REDEYEREDUCTION | redeye 감소 기능을 사용하도록 설정합니다. 이 플래그는 다른 설정과 결합할 수 있습니다. |
| KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASH | 하나의 트리거에 대해서만 플래시를 설정합니다. 카메라가 사진 시퀀스 모드가 아닌 경우 이 기능은 무시됩니다. |
| KSCAMERA_EXTENDEDPROP_FLASH_MULTIFLASHSUPPORTED | 모든 시퀀스 프레임에서 트리거되도록 플래시를 설정합니다. 카메라가 사진 시퀀스 모드가 아닌 경우 이 기능은 무시됩니다. |
KSCAMERA_EXTENDEDPROP_HEADERFlags 멤버에는 현재 카메라에 대해 설정된 플래시 모드가 포함되어 있습니다.
카메라의 기본 플래시 모드는 KSCAMERA_EXTENDEDPROP_FLASH_OFF. 카메라가 플래시, KSCAMERA_EXTENDEDPROP_FLASH_OFF, KSCAMERA_EXTENDEDPROP_FLASH_ON 및 KSCAMERA_EXTENDEDPROP_FLASH_AUTO 지원하는 경우 필수 모드입니다. KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER 및 KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER 모드는 선택 사항입니다.
카메라에서 사진 시퀀스 모드를 지원하는 경우 플래시 컨트롤 속성은 KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASH 지원해야 합니다.
이 속성 컨트롤은 동기적이며 취소할 수 없습니다.
설명
속성 가져오기
KSPROPERTY_TYPE_GET 요청에 응답할 때 드라이버는 KSCAMERA_EXTENDEDPROP_HEADER 멤버를 다음으로 설정합니다.
| 멤버 | 값 |
|---|---|
| 버전 | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE(0xFFFFFFFF) |
| 크기 | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) |
| 결과 | 0 |
| 기능 | 지원되는 플래시 모드 값 |
| 플래그 | (현재 플래시 모드 값 설정) | (플래시 기능 플래그) |
토치 모드가 KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER 또는 KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER 경우 KSCAMERA_EXTENDEDPROP_VALUEValue.ull 멤버에는 0~100 사이의 강도 수준 값이 포함됩니다. 강도 0은 최소 수준을 나타내고 강도는 100은 최대 강도 수준을 나타냅니다. 조정 가능한 전원 플래그를 설정하지 않으면 정규화된 강도 설정의 값이 Value.ull에 반환됩니다.
이전에 플래시 모드가 설정되지 않은 경우 플래그 는 KSCAMERA_EXTENDEDPROP_FLASH_OFF(기본값)로 설정됩니다.
속성 설정
속성이 설정되면 KSPROPERTY_TYPE_SET 요청인 KSCAMERA_EXTENDEDPROP_HEADERFlags 멤버에 설정할 토치 모드가 포함됩니다. KSCAMERA_EXTENDEDPROP_VALUE Value.ull 멤버에는 Flags가 KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER 또는 KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER 경우 설정할 강도 수준이 포함됩니다.
요구 사항
버전: Windows 8.1 시작
헤더: Ksmedia.h(Ksmedia.h 포함)