KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE

La propriété de contrôle d’exposition spécifie si le traitement automatique se produit pour une exposition ou une valeur de temps manuelle est utilisé à la place.

Tableau récapitulatif de l’utilisation

Obtenir Yammer	Définir	Cible	Type de descripteur de propriété	Type de valeur de propriété
Oui	Oui	Filtrer	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

La valeur de propriété (données d’opération) contient une structure KSCAMERA_EXTENDEDPROP_HEADER et une structure KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING.

La taille totale des données de propriété est sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING). Le membre Taille de KSCAMERA_EXTENDEDPROP_HEADER est défini sur cette taille totale de données de propriété.

Le membre de fonctionnalité de KSCAMERA_EXTENDEDPROP_HEADER contient une combinaison OR au niveau du bit d’une ou plusieurs des options de traitement vidéo suivantes.

Mode de traitement	Description
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO	Le pilote de caméra utilise sa propre logique de traitement pour la vidéo.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL	Le pilote de caméra utilise une méthode de traitement prédéfinie.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK	La méthode de traitement vidéo actuelle est verrouillée.

Le membre Indicateurs de KSCAMERA_EXTENDEDPROP_HEADER contient l’indicateur de traitement vidéo actuellement défini pour la caméra. Le paramètre KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO peut être combiné à KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK.

Ce contrôle de propriété est asynchrone et annulable.

Notes

Modes de traitement

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO

Cela indique que le traitement automatique est pris en charge. Le pilote utilisera sa logique interne pour optimiser le traitement vidéo. Pour une requête KSPROPERTY_TYPE_GET, le membre VideoProc de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING doit contenir la valeur déterminée par le pilote actuel pour le traitement vidéo.

Cet indicateur peut être combiné à KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK sous forme de valeur OR au niveau du bit.

Le verrouillage, sans combiner le mode Automatique, un contrôle déjà verrouillé doit être traité comme une opération sans opération par le pilote de la caméra. Le verrouillage, en combinaison avec le mode Automatique, un contrôle déjà verrouillé doit déclencher une nouvelle convergence.

Cet indicateur ne doit pas être combiné à KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL

Manuel indique que pour ce traitement vidéo, les valeurs spécifiques sont fournies. Des valeurs spécifiques sont fournies au pilote.

Cet indicateur ne doit pas être combiné avec KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO ou KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK.

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK

L’indicateur d’option de verrouillage indique que le traitement vidéo actuel est verrouillé sur la valeur actuellement programmée. Par exemple, une application peut demander le mode automatique jusqu’à ce qu’une exposition spécifique soit déterminée. À ce stade, l’application décidera de prendre une séquence de photos avec la même exposition. Dans ce cas, l’application peut spécifier l’indicateur KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK.

Cet indicateur ne doit pas être combiné à KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.

Obtention de la propriété

Lorsque vous répondez à une demande de KSPROPERTY_TYPE_GET, le pilote définit les membres de l’KSCAMERA_EXTENDEDPROP_HEADER sur ce qui suit.

Membre	Valeur
Version	1
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
Size	sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING)
Result	0
Fonctionnalité	KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL or au niveau du bit avec (mode de traitement vidéo pris en charge)
Indicateurs	Mode de traitement vidéo actuel

Si aucun mode d’exposition n’a été défini précédemment, le pilote définit les indicateurs sur KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO (valeur par défaut). Les membres de la structure KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING qui suit KSCAMERA_EXTENDEDPROP_HEADER sont définis en fonction des exigences du mode de traitement.

La valeur VideoProp.Value.ull doit contenir le paramètre d’exposition actuel lorsque le mode est KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO.

Définition de la propriété

Lorsque la propriété est définie, une demande de KSPROPERTY_TYPE_SET, le membre Indicateurs de KSCAMERA_EXTENDEDPROP_HEADER contient le mode d’exposition à définir. Le membre VideoProc.Value de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING doit être ignoré lorsque les indicateurs contiennent l’indicateur de mode KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO.

Spécifications

Version : disponible à partir de Windows 8.1

En-tête : ksmedia.h (include Ksmedia.h)

Voir aussi

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING