KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA

이 확장 속성 컨트롤은 클라이언트에서 메타데이터 버퍼 요구 사항에 대한 드라이버를 쿼리하는 데 사용됩니다. 표준 KSCAMERA_EXTENDEDPROP_HEADER 구조와 함께 드라이버로 전송되고 KSCAMERA_EXTENDEDPROP_METADATAINFO 구조가 뒤따릅니다.

사용량 요약 테이블

범위 컨트롤 형식

버전 1

Pin

동기

다음은 KSCAMERA_EXTENDEDPROP_HEADER 배치할 수 있는 메타데이터 플래그입니다 . 플래그 필드입니다.

#define KSCAMERA_EXTENDEDPROP_METADATA_SYSTEMMEMORY                     0x0000000000000001  
#define KSCAMERA_EXTENDEDPROP_METADATA_ALIGNMENTREQUIRED                0x0000000000000100

Get 호출에서 드라이버는 다음을 수행합니다.

  1. KSCAMERA_EXTENDEDPROP_HEADER 채웁니다 . 0이 있는 기능 .

  2. KSCAMERA_EXTENDEDPROP_HEADER 채웁니다. 위의 KSCAMERA_EXTENDEDPROP_METADATA_XXX 플래그를 조합하여 메타데이터 메모리 요구 사항을 나타내는 플래그입니다.

  3. KSCAMERA_EXTENDEDPROP_METADATAINFO 채웁니다. 원하는 메모리 맞춤을 사용하여 BufferAlignment(KSCAMERA_EXTENDEDPROP_MetadataAlignment_Xxx). 가능한 값은 KSCAMERA_EXTENDEDPROP_MetadataAlignment 참조하세요.

  4. KSCAMERA_EXTENDEDPROP_METADATAINFO 채웁니다 . MaxMetadataBufferSize 에 필요한 메타데이터 버퍼 크기(바이트)가 있습니다.

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

멤버 Description

버전

1이어야 합니다.

PinId

프레임에 메타데이터가 포함된 핀과 연결된 핀 ID여야 합니다. 미리 보기, 레코드 및 이미지 핀일 수 있습니다.

크기

sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_METADATAINFO)이어야 합니다.

결과

이는 마지막 SET 작업의 오류 결과를 나타냅니다. SET 작업이 수행되지 않은 경우 0이어야 합니다.

기능

사용되지 않으며 0이어야 합니다.

플래그

읽기/쓰기 필드입니다. 이는 KSCAMERA_EXTENDEDPROP_METADATA_ALIGNMENTREQUIRED 또는 KSCAMERA_EXTENDEDPROP_METADATA_SYSTEMMEMORY 조합일 수 있습니다.

요구 사항

헤더

Ksmedia.h