KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR
KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR 드라이버에서 HDR(High Dynamic Range) 비디오를 사용하거나 사용하지 않도록 설정하는 데 사용됩니다. 비디오 핀 전용 핀 수준 컨트롤입니다.
사용량 요약 테이블
| 가져오기 | 설정 | 대상 | 속성 설명자 형식 |
|---|---|---|---|
| Yes | Yes | Pin | KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR |
다음 플래그는 KSCAMERA_EXTENDEDPROP_HEADER 배치할 수 있습니다. 비디오 HDR을 제어하는 플래그 필드입니다. 기본적으로 드라이버는 VIDEOHDR_OFF 설정해야 합니다.
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF 0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON 0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO 0x0000000000000002
드라이버가 이 컨트롤을 지원하는 경우 VIDEOHDR_ON/VIDEOHDR_OFF 지원해야 합니다.
드라이버가 비디오 HDR을 지원하지 않는 경우 드라이버는 이 컨트롤을 구현해서는 안 됩니다.
이 컨트롤은 드라이버에 대한 힌트 역할을 합니다. VIDEOHDR_ON 설정하면 드라이버는 최상의 노력으로 비디오 HDR을 수행해야 합니다.
비디오 핀이 KSSTATE_RUN 상태일 때 이 컨트롤의 SET 호출은 영향을 주지 않습니다. 비디오 핀이 실행 중 상태이고 STATUS_INVALID_DEVICE_STATE 반환하는 경우 드라이버는 받은 SET 호출을 거부해야 합니다. GET 호출에서 드라이버는 플래그 필드에서 현재 설정을 반환해야 합니다.
다음 표에서는 플래그 기능에 대해 설명합니다.
| 플래그 | 설명 |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF | 필수 기능입니다. 지정된 경우 드라이버에서 비디오 HDR이 비활성화되고 드라이버는 비디오 스트림에서 비디오 HDR을 수행하지 않습니다. |
| KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON | 필수 기능입니다. 지정된 경우 드라이버에서 비디오 HDR을 사용하도록 설정하고 드라이버는 최상의 노력으로 비디오 HDR을 수행해야 합니다. 이 플래그는 VIDEOHDR_AUTO 및 VIDEOHDR_OFF 플래그와 함께 사용할 수 없습니다. |
| KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO | 이 기능은 선택 사항입니다. 지정된 경우 이러한 기능을 지원하는 드라이버는 장면 분석에 따라 비디오 HDR을 수행해야 하는지 여부를 결정합니다. 이 플래그는 VIDEOHDR_ON 및 VIDEOHDR_OFF 플래그와 함께 사용할 수 없습니다. |
아래 표에는 컨트롤을 사용할 때 KSCAMERA_EXTENDEDPROP_HEADER 구조 필드에 대한 설명과 요구 사항이 포함되어 있습니다.
| 멤버 | Description |
|---|---|
| 버전 | 1이어야 합니다. |
| PinId | 비디오 핀과 연결된 핀 ID여야 합니다. |
| 크기 | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)여야 합니다. |
| 결과 | 마지막 SET 작업의 오류 결과를 나타냅니다. SET 작업이 수행되지 않은 경우 0이어야 합니다. |
| 기능 | 위에 정의된 지원되는 KSCAMERA_EXTENDEDPROP_VIDEOHDR_* 플래그의 비트 OR이어야 합니다. |
| 플래그 | 읽기/쓰기 필드입니다. 위에서 정의한 KSCAMERA_EXTENDEDPROP_VIDEOHDR_* 플래그 중 하나일 수 있습니다. |
요구 사항
지원되는 최소 클라이언트: Windows 11
헤더: ksmedia.h(Ksmedia.h 포함)