KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE
La propriété mode focus contrôle les modes de focus automatique, manuel et prédéfini de l’appareil photo.
Tableau récapitulatif de l’utilisation
| Get | Set | Cible | Type de descripteur de propriété | Type de valeur de propriété |
|---|---|---|---|---|
Oui |
Oui |
Filtrer |
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 défini sur cette taille totale des données de propriété.
Le membre Capability de KSCAMERA_EXTENDEDPROP_HEADER contient une combinaison de bits OU d’une ou plusieurs des options de traitement vidéo suivantes.
| Traitement et mode focus | 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 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. |
| KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS | Aucun point focal convergent défini. |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_MACRO | Convergence focale de plage de macros. |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_NORMAL | Convergence focale de plage normale. |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE | Convergence focale de plage complète. |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_INFINITY | Convergence focale de plage infinie. |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_HYPERFOCAL | Plage hyperfocale. |
Le membre Indicateurs de KSCAMERA_EXTENDEDPROP_HEADER contient l’indicateur de traitement vidéo actuellement défini pour la caméra. Si KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO paramètre peut être combiné avec KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK.
Ce contrôle de propriété est asynchrone et annulable.
Remarques
Modes de traitement
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO
Cet indicateur indique que l’opération de focus automatique a convergé lorsque l’événement d’achèvement est déclenché. Une fois l’opération terminée, et lorsque cet indicateur n’est pas combiné avec KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK, le focus peut différer et le pilote de la caméra peut continuer à tenter la convergence. Si l’indicateur KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK est inclus, le focus est verrouillé sur la première convergence et ne change pas tant qu’une nouvelle commande de focus n’est pas reçue.
En cas de 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 l’appareil photo. Le verrouillage, en combinaison avec le mode automatique, un contrôle déjà verrouillé doit déclencher une nouvelle convergence.
Cet indicateur s’exclue mutuellement des indicateurs KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL et KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.
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, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK ou KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK
Lorsque cet indicateur est défini sans indicateur de KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO correspondant, le pilote de l’appareil photo est censé verrouiller l’état du focus actuel et déclencher l’événement d’achèvement une fois le focus verrouillé. Le pilote de caméra ne doit pas faire varier l’état du focus tant qu’une nouvelle commande de focus n’est pas reçue. Si KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO combiné cet indicateur, le pilote de la caméra converge vers le focus automatique et verrouille le focus sur ce point convergé, puis déclenche l’événement d’achèvement. Cet indicateur ne doit pas être combiné avec KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS ou KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.
Cet indicateur ne peut pas être spécifié avec un indicateur de plage pour le contrôle de focus, sauf s’il est combiné avec KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO. Dans ce cas, le focus est effectué à l’aide de l’indicateur de plage pour déterminer où tenter l’analyse du focus automatique. Ensuite, lors de la convergence, le paramètre de focus se verrouille et l’événement d’achèvement se déclenche.
KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS
Cet indicateur indique que le focus est continu. Il n’existe pas de point de convergence unique pour le contrôle du focus dans ce cas. Le pilote doit accepter cette demande et effectuer immédiatement l’opération asynchrone.
Cet indicateur ne doit pas être combiné avec KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK ou KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.
Ce mode est requis pour tous les pilotes.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_MACRO
Cet indicateur indique que la convergence du focus doit être effectuée pour la plage de macros. La plage focale exacte est déterminée par le pilote. Cet indicateur peut être combiné avec KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO et KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_NORMAL
Cet indicateur indique que la convergence du focus doit être effectuée pour la plage normale. La plage focale exacte est déterminée par le pilote. Cet indicateur peut être combiné avec KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO et KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE
Cet indicateur indique que la convergence du focus doit être effectuée pour la plage complète. La plage focale exacte est déterminée par le pilote. Cet indicateur peut être combiné avec KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO et KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.
Ce mode est requis pour tous les pilotes.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_INFINITY
Cet indicateur indique que la convergence du focus doit être effectuée pour la plage infinie. La plage focale exacte est déterminée par le pilote. Cet indicateur peut être combiné avec KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO et KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_HYPERFOCAL
Cet indicateur indique que la convergence du focus doit être effectuée pour la plage hyperfocale. La plage focale exacte est déterminée par le pilote. Cet indicateur peut être combiné avec KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO et KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.
Obtention de la propriété
Lors de la réponse à une demande de KSPROPERTY_TYPE_GET, le pilote définit les membres du KSCAMERA_EXTENDEDPROP_HEADER comme suit.
| Membre | Valeur |
|---|---|
| Version | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF). |
| Taille | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) |
| Résultats | 0 |
| Fonctionnalité | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE | (Traitement vidéo et modes focus pris en charge) |
| Indicateurs | Traitement vidéo actuel et mode focus. |
Si aucun indicateur de plage de focus n’a été défini précédemment, le pilote définit indicateurs sur KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE avec 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 focus.
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 Flags de KSCAMERA_EXTENDEDPROP_HEADER contient le mode focus à définir. Le membre VideoProc.Value de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING doit être ignoré lorsque flags contient les indicateurs KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.
Spécifications
Version |
Disponible à partir de Windows 8.1. |
En-tête |
Ksmedia.h (inclure Ksmedia.h) |