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 포함)

추가 정보

2.2.2.13 비디오 HDR 컨트롤