Partager via

KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM

  • Article

KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM est un ID de propriété qui sera utilisé pour contrôler les métadonnées d’histogramme produites par le pilote. Il s’agit d’un contrôle de niveau de broche pour l’épingle d’aperçu uniquement.

Tableau récapitulatif de l’utilisation

Étendue Control Type

version 1

Épingle

Synchrone

Les indicateurs suivants peuvent être placés dans le KSCAMERA_EXTENDEDPROP_HEADER. Champ Indicateurs pour contrôler les métadonnées d’histogramme dans le pilote. La valeur par défaut est HISTOGRAM_OFF.

#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_OFF      0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_ON       0x0000000000000001

Ce contrôle doit être utilisé avant le contrôle KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA pour garantir l’allocation de la mémoire tampon de métadonnées de taille appropriée.

S’il est défini sur HISTOGRAM_OFF, le pilote ne doit pas remettre les métadonnées d’histogramme sur l’épingle d’aperçu. Le pilote ne doit pas inclure la taille des métadonnées de l’histogramme dans ses exigences de taille de mémoire tampon de métadonnées.

S’il est défini sur HISTOGRAM_ON, le pilote doit remettre les métadonnées d’histogramme sur l’épingle d’aperçu. Le pilote doit inclure la taille des métadonnées de l’histogramme dans son exigence de taille de mémoire tampon de métadonnées.

Si le pilote n’a pas la capacité de produire des métadonnées d’histogramme, il ne doit pas implémenter ce contrôle. Si le pilote prend en charge ce contrôle, il doit également prendre en charge KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA contrôle.

L’appel SET de ce contrôle n’a aucun effet lorsque la broche d’aperçu est dans un état supérieur à l’état KSSTATE_STOP. Le pilote doit rejeter l’appel SET reçu si l’aperçu n’est pas à l’état d’arrêt et retourne STATUS_INVALID_DEVICE_STATE. Dans un appel GET , le pilote doit retourner les paramètres actuels dans le champ Indicateurs .

Le tableau suivant contient les descriptions et les conditions requises pour les champs de structure KSCAMERA_EXTENDEDPROP_HEADER lors de l’utilisation du contrôle.

Membre Description

Version

Cela doit être 1.

PinId

Doit être l’ID de code pin associé à l’épingle d’aperçu.

Taille

Il doit s’agir de sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE).

Résultats

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é

Doit être égal à 0.

Indicateurs

Il s’agit d’un champ en lecture/écriture. Il peut s’agir d’un des indicateurs KSCAMERA_EXTENDEDPROP_HISTOGRAM_* définis ci-dessus.

Configuration requise

En-tête

 Ksmedia.h