Compartir a través de

KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA

  • Artículo

El cliente usa este control de propiedad extendida para consultar al controlador los requisitos del búfer de metadatos. Se envía al controlador junto con una estructura estándar KSCAMERA_EXTENDEDPROP_HEADER seguida de una estructura de KSCAMERA_EXTENDEDPROP_METADATAINFO .

Tabla de resumen de uso

Ámbito Control Tipo

versión 1

Anclar

Sincrónico

A continuación se muestran las marcas de metadatos que se pueden colocar en el KSCAMERA_EXTENDEDPROP_HEADER. Campo Marcas .

#define KSCAMERA_EXTENDEDPROP_METADATA_SYSTEMMEMORY                     0x0000000000000001  
#define KSCAMERA_EXTENDEDPROP_METADATA_ALIGNMENTREQUIRED                0x0000000000000100

En una llamada Get , el controlador hace lo siguiente:

  1. Rellena KSCAMERA_EXTENDEDPROP_HEADER. Funcionalidad con 0.

  2. Rellene KSCAMERA_EXTENDEDPROP_HEADER. Marcas con una combinación de cualquiera de las marcas anteriores KSCAMERA_EXTENDEDPROP_METADATA_XXX para indicar los requisitos de memoria de metadatos.

  3. Rellene KSCAMERA_EXTENDEDPROP_METADATAINFO. BufferAlignment con la alineación de memoria deseada (KSCAMERA_EXTENDEDPROP_MetadataAlignment_Xxx). Consulte la KSCAMERA_EXTENDEDPROP_MetadataAlignment para conocer los valores posibles.

  4. Rellene KSCAMERA_EXTENDEDPROP_METADATAINFO. MaxMetadataBufferSize con el tamaño de búfer de metadatos necesario en bytes.

La tabla siguiente contiene las descripciones y los requisitos de los campos de estructura de KSCAMERA_EXTENDEDPROP_HEADER al usar el control de metadatos.

Miembro Descripción

Versión

Debe ser 1.

PinId

Debe ser el identificador de pin asociado al pin cuyo marco contiene metadatos. Puede ser cualquiera de las patillas de vista previa, registro e imagen.

Size

Debe ser sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_METADATAINFO),

Resultado

Esto indica los resultados del error de la última operación SET. Si no se ha realizado ninguna operación SET, debe ser 0.

Capacidad

Esto no se usa y debe ser 0.

Marcas

Se trata de un campo de lectura y escritura. Puede ser cualquier combinación de KSCAMERA_EXTENDEDPROP_METADATA_ALIGNMENTREQUIRED o KSCAMERA_EXTENDEDPROP_METADATA_SYSTEMMEMORY.

Requisitos

Encabezado

 Ksmedia.h