KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM

KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM 드라이버에서 생성한 히스토그램 메타데이터를 제어하는 데 사용되는 속성 ID입니다. 미리 보기 핀에 대한 핀 수준 컨트롤입니다.

사용량 요약 테이블

범위	컨트롤	형식
버전 1	Pin	동기

KSCAMERA_EXTENDEDPROP_HEADER 다음 플래그를 배치할 수 있습니다 . 드라이버에서 히스토그램 메타데이터를 제어하는 플래그 필드입니다. 기본값은 HISTOGRAM_OFF.

#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_OFF      0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_ON       0x0000000000000001

적절한 크기의 메타데이터 버퍼가 할당되도록 하려면 KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA 컨트롤 앞에 이 컨트롤을 사용해야 합니다.

HISTOGRAM_OFF 설정하면 드라이버는 미리 보기 핀에 히스토그램 메타데이터를 제공하지 않습니다. 드라이버는 메타데이터 버퍼 크기 요구 사항에 히스토그램 메타데이터 크기를 포함해서는 안 됩니다.

HISTOGRAM_ON 설정하면 드라이버는 미리 보기 핀에 히스토그램 메타데이터를 전달해야 합니다. 드라이버는 메타데이터 버퍼 크기 요구 사항에 히스토그램 메타데이터 크기를 포함해야 합니다.

드라이버에 히스토그램 메타데이터를 생성할 수 있는 기능이 없는 경우 드라이버는 이 컨트롤을 구현하면 안 됩니다. 드라이버가 이 컨트롤을 지원하는 경우 KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA 컨트롤도 지원해야 합니다.

미리 보기 핀이 KSSTATE_STOP 상태보다 높은 상태에 있는 경우 이 컨트롤의 SET 호출은 영향을 주지 않습니다. 미리 보기가 중지 상태가 아니고 STATUS_INVALID_DEVICE_STATE 반환하는 경우 드라이버는 수신된 SET 호출을 거부해야 합니다. GET 호출에서 드라이버는 Flags 필드에 현재 설정을 반환해야 합니다.

다음 표에는 컨트롤을 사용할 때 KSCAMERA_EXTENDEDPROP_HEADER 구조 필드에 대한 설명과 요구 사항이 포함되어 있습니다.

멤버	Description
버전	1이어야 합니다.
PinId	미리 보기 핀과 연결된 핀 ID여야 합니다.
크기	sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)여야 합니다.
결과	마지막 SET 작업의 오류 결과를 나타냅니다. SET 작업이 수행되지 않은 경우 0이어야 합니다.
기능	0이어야 합니다.
플래그	읽기/쓰기 필드입니다. 위에서 정의한 KSCAMERA_EXTENDEDPROP_HISTOGRAM_* 플래그 중 하나일 수 있습니다.

요구 사항

헤더

Ksmedia.h