Partager via


KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA

Ce contrôle de propriété étendu est utilisé par le client pour interroger le pilote pour connaître les exigences de mémoire tampon de métadonnées. Il est envoyé au pilote avec une structure de KSCAMERA_EXTENDEDPROP_HEADER standard suivie d’une structure KSCAMERA_EXTENDEDPROP_METADATAINFO .

Tableau récapitulatif de l’utilisation

Étendue Control Type

version 1

Épingle

Synchrone

Les indicateurs de métadonnées suivants peuvent être placés dans le KSCAMERA_EXTENDEDPROP_HEADER. Champ Indicateurs .

#define KSCAMERA_EXTENDEDPROP_METADATA_SYSTEMMEMORY                     0x0000000000000001  
#define KSCAMERA_EXTENDEDPROP_METADATA_ALIGNMENTREQUIRED                0x0000000000000100

Dans un appel Get , le pilote effectue les opérations suivantes :

  1. Remplit KSCAMERA_EXTENDEDPROP_HEADER. Fonctionnalité avec 0.

  2. Remplissez KSCAMERA_EXTENDEDPROP_HEADER. Indicateurs avec une combinaison de l’un des indicateurs KSCAMERA_EXTENDEDPROP_METADATA_XXX ci-dessus pour indiquer les besoins en mémoire des métadonnées.

  3. Remplissez KSCAMERA_EXTENDEDPROP_METADATAINFO. BufferAlignment avec l’alignement de mémoire souhaité (KSCAMERA_EXTENDEDPROP_MetadataAlignment_Xxx). Consultez la KSCAMERA_EXTENDEDPROP_MetadataAlignment pour connaître les valeurs possibles.

  4. Remplissez KSCAMERA_EXTENDEDPROP_METADATAINFO. MaxMetadataBufferSize avec la taille de mémoire tampon de métadonnées requise en octets.

Le tableau ci-dessous contient les descriptions et les exigences pour les champs de structure KSCAMERA_EXTENDEDPROP_HEADER lors de l’utilisation du contrôle de métadonnées.

Membre Description

Version

Cela doit être 1.

PinId

Il doit s’agir de l’ID d’épingle associé à l’épingle dont le cadre contient des métadonnées. Il peut s’agir de l’aperçu, de l’enregistrement et de l’épingle d’image.

Taille

Il doit s’agir de sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_METADATAINFO),

Résultats

Cela indique les résultats d’erreur de la dernière opération SET. Si aucune opération SET n’a eu lieu, il doit s’agir de 0.

Fonctionnalité

Cette valeur est inutilisée et doit être 0.

Indicateurs

Il s’agit d’un champ en lecture/écriture. Il peut s’agir de n’importe quelle combinaison de KSCAMERA_EXTENDEDPROP_METADATA_ALIGNMENTREQUIRED ou de KSCAMERA_EXTENDEDPROP_METADATA_SYSTEMMEMORY.

Configuration requise

En-tête

Ksmedia.h