다음을 통해 공유

KSPROPERTY_CAMERACONTROL_EXTENDED_RELATIVEPANELOPTIMIZATION

  • 아티클

KSPROPERTY_CAMERACONTROL_EXTENDED_RELATIVEPANELOPTIMIZATION 애플리케이션의 활성 디스플레이를 기준으로 카메라가 전면을 향하고 있는지 여부를 드라이버에 알리는 데 사용되는 속성 ID입니다. Windows는 새 WinRT API 속성 PanelBasedOptimizationControl.Panel이 설정되면 속성을 설정합니다.

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

사용량 요약 테이블

가져오기 설정 대상 속성 설명자 형식 속성 값 형식
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_HEADER 배치할 수 있는 플래그입니다. 플래그 및 KSCAMERA_EXTENDEDPROP_HEADER. 기능 필드.

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

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

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

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

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

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

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

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

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

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

ACPI PLD에 대한 열거형 값일 수 있지만 가장 자주 전면, 뒤로 또는 알 수 없음이 됩니다.

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

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

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

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

요구 사항

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