Partager via

KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM

  • Article

KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM est utilisé pour contrôler le zoom numérique. Il est défini dans l’énumération KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY et est utilisé pour obtenir et définir le rapport de zoom et obtenir les plages de zoom à partir du pilote. Dans Windows 10, ce contrôle est étendu pour prendre également en charge le zoom lisse.

Tableau récapitulatif de l’utilisation

Étendue Control Type

version 1

Filtrer

Synchrone

Les indicateurs suivants peuvent être placés dans le KSCAMERA_EXTENDEDPROP_HEADER. Champ indicateurs pour contrôler le zoom lisse par rapport au zoom direct. La valeur par défaut est définie par le pilote.

#define KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT  0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_ZOOM_DIRECT   0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_ZOOM_SMOOTH   0x0000000000000002

Si le pilote prend en charge ce contrôle, il doit prendre en charge KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT.

Si le pilote ne prend pas en charge le zoom numérique, il ne doit pas implémenter ce contrôle.

Le tableau suivant décrit les fonctionnalités d’indicateur.

Indicateur Description

KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT

Il s’agit d’une fonctionnalité obligatoire. Lorsqu’il est spécifié, le pilote décide si un zoom direct ou un zoom lisse doit être appliqué et effectue un zoom sur le facteur de zoom cible spécifié dans VideoProc.Value.ul en conséquence. Cet indicateur s’exclut mutuellement des indicateurs DIRECT et SMOOTH.

KSCAMERA_EXTENDEDPROP_ZOOM_DIRECT

Il s’agit d’une fonctionnalité obligatoire. Quand il est spécifié, le pilote effectue un zoom sur le facteur de zoom cible spécifié dans VideoProc.Value.ul aussi rapidement que possible. Cet indicateur s’exclut mutuellement avec les indicateurs AUTO et SMOOTH.

KSCAMERA_EXTENDEDPROP_ZOOM_SMOOTH

Cette fonctionnalité est facultative. Quand il est spécifié, le pilote effectue un zoom progressif sur le facteur de zoom cible spécifié dans VideoProc.Value.ul de manière fluide. Le nombre d’images nécessaire pour atteindre le facteur de zoom spécifié appartient au pilote. Cet indicateur s’exclut mutuellement avec les indicateurs AUTO et DIRECT.

Pour chaque appel GET , le pilote doit signaler les plages de zoom actuelles autorisées en fonction des configurations ou de la configuration actuelles.

Le tableau suivant contient les descriptions et la configuration requise pour les champs de structure KSCAMERA_EXTENDEDPROP_HEADER lors de l’utilisation de la propriété KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM .

Membre Description

Version

Ce doit être 1,

PinId

Ce doit être KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF),

Taille

Il doit s’agir de sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING),

Résultats

Cela 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 un OR au niveau du bit des indicateurs pris en charge définis ci-dessus.

Indicateurs

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

Le tableau ci-dessous contient les descriptions et la configuration requise pour les champs de structure KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING pour la propriété KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM .

Membre Description

Mode

Cette valeur est inutilisée et doit être 0.

Min/Max/Step

Min/Max/Step contient le nombre minimal/maximum/incrément du rapport de zoom pris en charge par le pilote de l’appareil photo au format Q16. Le pilote doit retourner ces valeurs pour les opérations GET .

VideoProc

Pour les opérations SET , videoProc.Value.ul doit spécifier le taux de zoom dans la plage décrite par le paramètre Min/Max/Step. Pour les opérations GET , le pilote doit retourner le rapport de zoom actuel.

Réservé

Cette valeur n’est pas utilisée. Cela doit être ignoré par le pilote.

Ce contrôle de propriété est synchrone et n’est pas annulable.

Configuration requise

En-tête

 Ksmedia.h