Propriétés du contrôle d’appareil photo étendu

L’interface de contrôle de caméra étendue, disponible à partir de Windows 8, est utilisée pour contrôler les fonctionnalités de la caméra lors de la capture d’image. Le pilote peut contrôler ces fonctionnalités de caméra :

• flash de l’appareil photo
• si l’épingle d’image et la broche d’enregistrement s’excluent mutuellement
• la région d’intérêt dans l’image
• stabilisation vidéo

Le pilote peut également choisir d’effectuer une opération de contrôle de caméra de manière asynchrone, ce qui signifie que toutes les demandes d’une opération sont rejetées jusqu’à ce que la première demande soit terminée. Si le pilote a correctement effectué des opérations de contrôle de caméra asynchrones, il doit déclencher l’événement KSEVENTSETID_CameraAsyncControl . Pour plus d’informations, consultez KSPROPERTY_CAMERACONTROL_S_EX .

Les applications UWP peuvent accéder à ces propriétés pour configurer la caméra :

Propriétés

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY
Utilisé pour activer ou désactiver le flash de l’appareil photo, ou pour mettre le flash en mode automatique.

KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_PROPERTY
Permet d’identifier si la broche d’image et la broche d’enregistrement de l’appareil photo s’excluent mutuellement.

KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_PROPERTY
Permet d’obtenir ou de définir la caractéristique de la zone d’intérêt d’une caméra.

KSPROPERTY_CAMERACONTROL_VIDEO_STABILIZATION_MODE_PROPERTY
Utilisé pour obtenir ou définir les caractéristiques de stabilisation vidéo d’une caméra.

Les propriétés suivantes sont disponibles à partir de Windows 8.1.

Terme	Description
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE	Permet d’obtenir ou de définir un mode normal de séquence de photos ou de photos pour l’appareil photo.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOFRAMERATE	Permet d’obtenir la fréquence d’images de capture photo actuelle lorsque le mode photo de l’appareil photo est le mode séquence.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE	Permet d’obtenir ou de définir la fréquence d’images maximale d’un appareil photo lorsqu’il est en mode séquence photo.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTRIGGERTIME	Permet d’obtenir ou de définir l’heure de déclenchement pour le pilote de la caméra.
KSPROPERTY_CAMERACONTROL_EXTENDED_WARMSTART	Permet d’obtenir ou de définir l’état de démarrage à chaud (appareil photo prêt).
KSPROPERTY_CAMERACONTROL_EXTENDED_MAXVIDFPS_PHOTORES	Permet d’obtenir ou de définir la fréquence d’images maximale possible sur les broches de capture vidéo à une certaine résolution.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTHUMBNAIL	Permet d’obtenir ou de définir la fonctionnalité de miniature pour l’appareil photo.
KSPROPERTY_CAMERACONTROL_EXTENDED_SCENEMODE	Permet d’obtenir ou de définir un mode défini par le pilote qui représente une collection de contrôles prédéfinis.
KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE	Utilisé pour obtenir ou définir la méthode le flash d’un appareil photo est utilisé dans des conditions de faible luminosité.
KSPROPERTY_CAMERACONTROL_EXTENDED_FLASHMODE	Permet d’obtenir ou de définir le mode flash pour le mode photo normal et le mode séquence de l’appareil photo.
KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT	Permet d’obtenir ou de définir si le traitement automatique se produit pour la balance des blancs ou pour une valeur de température manuelle.
KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE	Permet d’obtenir ou de définir si l’appareil photo est optimisé pour l’opération photo ou vidéo.
KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE	Permet d’obtenir ou de définir si le traitement automatique est effectué pour l’exposition ou si une valeur de temps manuelle est utilisée.
KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE	Permet d’obtenir ou de définir les modes de focus automatique, manuel et prédéfini de l’appareil photo.
KSPROPERTY_CAMERACONTROL_EXTENDED_ISO	Permet d’obtenir ou de définir le paramètre ISO prédéfini ou automatique pour l’appareil photo.
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW	Utilisé pour obtenir le champ de vision et l’angle de tangage de la position de la caméra.
KSPROPERTY_CAMERACONTROL_EXTENDED_EVCOMPENSATION	Permet d’obtenir ou de définir le paramètre d’ajustement du contrôle d’exposition.
KSPROPERTY_CAMERACONTROL_EXTENDED_CAMERAANGLEOFFSET	Utilisé pour obtenir le tangage et l’angle de lacet de la position de la caméra.

Ces structures et énumérations prennent en charge l’interface de contrôle de caméra étendue :

Structures

• KSPROPERTY_CAMERACONTROL_S_EX
• KSPROPERTY_CAMERACONTROL_FLASH_S
• KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_S
• KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S
• KSPROPERTY_CAMERACONTROL_VIDEOSTABILIZATION_MODE_S
• KSCAMERA_EXTENDEDPROP_HEADER
• KSCAMERA_EXTENDEDPROP_VALUE
• KSCAMERA_EXTENDEDPROP_PHOTOMODE
• KSCAMERA_MAXVIDEOFPS_FORPHOTORES
• KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING
• KSCAMERA_EXTENDEDPROP_FIELDOFVIEW

Énumérations

• KS_CameraControlAsyncOperation
• KSEVENT_CAMERACONTROL
• KSPROPERTY_CAMERACONTROL_FLASH
• KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY
• KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST
• KSPROPERTY_CAMERACONTROL_VIDEO_STABILIZATION_MODE

L’exemple de code de pilote qui implémente cette interface est fourni dans How To Implement Extended Camera Control Properties.