KSPROPERTY_CAMERACONTROL_EXTENDED_RELATIVEPANELOPTIMIZATION

KSPROPERTY_CAMERACONTROL_EXTENDED_RELATIVEPANELOPTIMIZATION 응용 프로그램의 활성 디스플레이를 기준으로 카메라가 전면에 있는지 여부를 드라이버에 알리는 데 사용되는 속성 ID입니다. Windows 새 WinRT API 속성 PanelBasedOptimizationControl.Panel이 설정된 경우 속성을 설정합니다.

KSProperty 컨트롤을 설정하는 예제는 GitHub AVStream 카메라 샘플 드라이버에서 찾을 수 있습니다.

사용량 요약 테이블

가져오기	설정	대상	속성 설명자 형식	속성 값 형식
예	예	Assert	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

설명

속성 요청에는 KSCAMERA_EXTENDEDPROP_HEADER 구조체와 KSCAMERA_EXTENDEDPROP_VALUE 구조가 포함됩니다.

총 속성 데이터 크기는 .입니다 sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE).

KSCAMERA_EXTENDEDPROP_HEADERSize 멤버는 이 총 속성 데이터 크기로 설정됩니다.

다음은 KSCAMERA_EXTENDEDPROP_HEADER 배치할 수 있는 플래그입니다 . 플래그 및 KSCAMERA_EXTENDEDPROP_HEADER. 기능 필드입니다 .

상대 패널 최적화 모드	설명
KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF	카메라는 정상 작동 모드를 사용합니다.
KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON	카메라는 값 필드에 설명된 위치를 기준으로 최적화를 사용합니다.
KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_DYNAMIC	스트림을 결함 없이 스트리밍하는 동안 카메라 위치 힌트를 동적으로 조정할 수 있습니다.

KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION 항상 동기 컨트롤입니다.

모든 앱은 속성을 읽을 수 있지만 전용 액세스를 위해 카메라를 연 앱만 속성 값에 쓸 수 있습니다.

단독 모드 액세스 없이 속성을 작성하려고 하면 적절한 오류 코드가 반환됩니다.

이 DDI를 PanelBasedOptimizationControl에 매핑하는 것과 관련하여 PanelBasedOptimizationControl을 사용하는 애플리케이션은 패널 값을 설정하며, Windows 페이로드의 KSCAMERA_EXTENDEDPROP_VALUE 필드를 프로그래밍하는 데 내부적으로 사용합니다.

기능 및 플래그 필드는 Windows 의해 제어됩니다.

카메라 디바이스가 스트리밍되는 동안 드라이버가 SET 작업을 수신하고 플래그 KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_DYNAMIC*가 설정되지 않은 경우 드라이버는 상태 기반 오류를 반환합니다.

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

멤버	설명
버전	1이어야 합니다.
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE(0xFFFFFFFF)
크기	sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)여야 합니다.
결과	마지막 SET 작업의 오류 결과를 나타냅니다. SET 작업이 수행되지 않은 경우 0이어야 합니다.
기능	위에 정의된 지원되는 KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_XXX 플래그의 비트 OR여야 합니다.
플래그	읽기/쓰기 필드입니다. 위에서 정의한 KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON 또는 KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF 플래그일 수 있습니다.

KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON KSCAMERA_EXTENDEDPROP_HEADER플래그 필드에 지정된 경우 Value.ul 필드는 카메라가 현재 향하고 있는 상대 방향에 대한 PLD를 지정해야 합니다.

ACPI PLD에 대한 열거형 값일 수 있지만 가장 자주 는 Front, Back 또는 Unknown입니다.

KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF 지정한 경우 SET 작업의 경우 값 필드는 무시됩니다.

GET 작업의 경우 드라이버는 카메라가 현재 프로그래밍된 방향을 반환해야 합니다.

KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF 지정하거나 값이 설정되지 않은 경우 디바이스의 기본 PLD를 반환해야 합니다.

KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON 지정한 경우 가장 최근에 설정한 값이 반환되어야 합니다.

요구 사항

헤더: ksmedia.h(Ksmedia.h 포함)