KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE
La propriété du mode de balance des blancs spécifie si le traitement automatique a lieu pour la balance des blancs ou si une valeur de température 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 ou une méthode basée sur la température. |
| 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 non 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. Dans le cas de la balance des blancs, il doit contenir la température actuelle en Kelvin. Le membre Mode est ignoré pour le fonctionnement automatique.
Cet indicateur peut être combiné avec KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK comme une valeur binaire OU. Lorsqu’il est verrouillé, le comportement attendu du pilote de la caméra est de converger sur la balance des blancs et de verrouiller la valeur de la balance des blancs sur la valeur convergée, sans tenter de refaire la balance des blancs automatique, jusqu’à ce qu’une nouvelle commande de balance des blancs soit reçue.
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.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL
Manuel indique que pour ce traitement vidéo, des valeurs spécifiques sont fournies. Dans le cas de la balance des blancs, si le membre Mode de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING indique KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE, le VideoProc.Value.ul contiendra la valeur de la température en degrés Kelvin.
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 balance des blancs spécifique soit déterminée. À ce moment-là, l’application décidera de prendre une série de photos toutes avec le même réglage de balance des blancs. Dans un tel cas, l’application peut spécifier l’indicateur KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK. Le pilote de la caméra veillera à ce que les informations de balance des blancs ne changent pas entre les différentes photos.
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 de balance des blancs 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.
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 de balance des blancs à 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)