KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE
La propriété de contrôle de l’exposition spécifie si le traitement automatique a lieu pour l’exposition ou si une valeur de temps manuelle est utilisée à la place.
Tableau récapitulatif d’utilisation
| Obtenir Yammer | Définir | Cible | Tableau récapitulatif d’utilisation | 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 Size de KSCAMERA_EXTENDEDPROP_HEADER est ajusté sur cette valeur de taille totale des données de propriété.
Le membre Capability de KSCAMERA_EXTENDEDPROP_HEADER contient une combinaison binaire OU d’une ou plusieurs des options de traitement vidéo suivantes.
| Mode de traitement | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO | Le pilote de la caméra utilise sa propre logique de traitement pour la vidéo. |
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL | Le pilote de la 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 Flags de KSCAMERA_EXTENDEDPROP_HEADER contient l'indicateur de traitement vidéo actuellement défini pour la caméra. Le réglage KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO peut être combiné avec 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 demande KSPROPERTY_TYPE_GET, le membre VideoProc de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING doit contenir la valeur déterminée par le pilote pour le traitement vidéo.
Cet indicateur peut être combiné avec KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK comme une valeur binaire OU.
Verrouiller, sans combiner avec le mode Auto, un contrôle déjà verrouillé doit être traité comme une opération nulle par le pilote de la caméra. Verrouiller, en combinaison avec le mode Auto, un contrôle déjà verrouillé doit déclencher une nouvelle convergence.
Cet indicateur ne doit pas être combiné avec KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL
Manuel indique que pour ce traitement vidéo, des valeurs spécifiques sont fournies. Les 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 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 moment-là, l’application décidera de prendre une série de photos toutes avec la même exposition. Dans un tel cas, l’application peut spécifier l’indicateur KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK.
Cet indicateur ne doit pas être combiné avec KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.
Obtenir la propriété
Lorsqu’il répond à une requête de KSPROPERTY_TYPE_GET, le pilote définit les membres de KSCAMERA_EXTENDEDPROP_HEADER de la manière suivante.
| 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 en binaire OU avec (mode de traitement vidéo pris en charge) |
| Indicateurs | Le mode de traitement vidéo actuel |
Si aucun mode d’exposition n’a été défini précédemment, le pilote définit Flags sur KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO (par défaut). Les membres de la structure KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING qui suit KSCAMERA_EXTENDEDPROP_HEADER sont définis selon les exigences du mode de traitement.
La valeur VideoProp.Value.ull doit contenir le réglage actuel de l’exposition lorsque le mode est KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO.
Définir la propriété
Lorsque la propriété est définie, une demande KSPROPERTY_TYPE_SET, le membre Flags de KSCAMERA_EXTENDEDPROP_HEADER contiendra le mode d’exposition à définir. Le membre VideoProc.Value de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING doit être ignoré lorsque Flags contient 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)