Constantes de propriété de périphérique d’appareil photo

Windows les périphériques matériels d’Acquisition d’images (WIA) ont des valeurs de propriété qui sont stockées dans le registre Windows. Pour plus d’informations, consultez constantes de propriété d’appareil courantes.

Les constantes de propriété d’appareil suivantes, avec leurs chaînes associées, sont spécifiques aux appareils photo numériques. Le préfixe « WIA _ DPC _ » indique une propriété d’appareil pour les appareils photo et est la Convention d’affectation de noms utilisée en C/C++. À des fins de script, ces constantes utilisent le préfixe « CameraDevice » et font partie du type énuméré WiaItemPropertyId . Le nom de membre correspondant de cette énumération de script apparaît entre parenthèses à côté du nom de constante C/C++ dans la liste suivante.

Notes

WIA ne prend pas en charge les caméras dans Windows Vista ou version ultérieure. pour ces versions du Windows, utilisez l’API de l’appareil Portable Windows (WPD) décrite dans le kit de développement de pilotes (DDK) Windows pour obtenir des images à partir d’appareils photo.

Constante/valeur Description
WIA_DPC_PICTURES_TAKEN
CameraDevicePicturesTaken
Nombre d’images prises par l’appareil photo. Le minipilote crée et gère cette propriété.
Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE
WIA_DPC_PICTURES_REMAINING
CameraDevicePicturesRemaining
Nombre d’images pouvant être prises, en fonction des paramètres de propriété actuels. Si ces paramètres changent et que les modifications affectent la taille des images générées par l’appareil photo, le minipilote WIA doit mettre à jour le nombre d’images restantes. Le minipilote crée et gère cette propriété.
Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE
WIA_DPC_EXPOSURE_MODE
CameraDeviceExposureMode
Indique le mode d’exposition actuel de l’appareil photo. Une application modifie cette propriété pour contrôler le mode d’exposition de l’appareil photo.
Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_LIST
Le tableau suivant contient les sept constantes qui sont valides avec cette propriété.
Mode exposition Description
EXPOSUREMODE_MANUAL La vitesse et l’ouverture de l’obturateur sont définies par l’utilisateur.
EXPOSUREMODE_AUTO La vitesse et l’ouverture de l’obturateur sont automatiquement définies par l’appareil photo.
EXPOSUREMODE_APERTURE_PRIORITY L’ouverture est définie par l’utilisateur et l’appareil photo définit automatiquement la vitesse d’obturation.
EXPOSUREMODE_SHUTTER_PRIORITY La vitesse d’obturation est définie par l’utilisateur et l’appareil photo définit automatiquement l’ouverture.
EXPOSUREMODE_PROGRAM_CREATIVE La vitesse et l’ouverture de l’obturateur sont automatiquement définies par l’appareil photo, optimisée pour les sujets toujours sujets.
EXPOSUREMODE_PROGRAM_ACTION La vitesse et l’ouverture de l’obturateur sont automatiquement définies par l’appareil photo, optimisée pour les scènes contenant un mouvement rapide.
EXPOSUREMODE_PORTRAIT La vitesse et l’ouverture de l’obturateur sont automatiquement définies par l’appareil photo, optimisé pour la photographie en portrait.

WIA_DPC_EXPOSURE_COMP
CameraDeviceExposureComp

Permet d’ajuster le point d’ensemble du contrôle d’exposition automatique de l’appareil photo numérique. Par exemple, un paramètre de zéro ne change pas le niveau d’exposition automatique défini par l’usine. Les unités sont des " arrêts " mis à l’échelle à l’aide d’un facteur de 1000, afin d’autoriser les valeurs d’arrêt fractionnaires. Un paramètre de 2000 correspond à deux arrêts supplémentaires (quatre fois plus d’énergie sur le capteur), ce qui génère des images plus claires. Un paramètre de-1000 correspond à une exposition moins faible (une demie de l’énergie sur le capteur) produisant des images plus sombres. Les valeurs des paramètres sont dans le système additif d’unités d’exposition photographique (APEX). Cette propriété peut être exprimée sous la forme d’une liste ou d’une plage de valeurs. Cette propriété est généralement utilisée uniquement lorsque la propriété WIA_DPC_EXPOSURE_MODE de l’appareil est définie sur EXPOSUREMODE_MANUAL.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_RANGE ou WIA_PROP_LIST

WIA_DPC_EXPOSURE_TIME
CameraDeviceExposureTime

Correspond à la vitesse d’obturation, en secondes, mise à l’échelle par 10 000. En règle générale, l’appareil utilise cette propriété uniquement lorsque la propriété WIA_DPC_EXPOSURE_MODE est définie sur EXPOSUREMODE_MANUAL ou EXPOSUREMODE_SHUTTER_PRIORITY.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_RANGE ou WIA_PROP_LIST

WIA_DPC_FNUMBER
CameraDeviceFNumber

Correspond à l’ouverture de la lentille, en unités du numéro d’arrêt f mis à l’échelle par 100. La valeur de cette propriété est généralement valide uniquement lorsque la propriété WIA_DPC_EXPOSURE_MODE a la valeur EXPOSUREMODE_MANUAL ou EXPOSUREMODE_APERTURE_PRIORITY.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_LIST

WIA_DPC_FLASH_MODE
CameraDeviceFlashMode

Définit le paramètre de mode flash en cours pour le périphérique de l’appareil photo. Le pilote de périphérique énumère les valeurs prises en charge de cette propriété. Une application écrit cette propriété pour définir le mode flash de l’appareil photo.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_LIST

Le tableau suivant contient les six constantes qui sont valides avec cette propriété.

Mode flash Définition
FLASHMODE_AUTO L’appareil photo détermine les paramètres de Flash appropriés.
FLASHMODE_FILL L’appareil photo est configuré pour clignoter indépendamment des conditions d’éclairage actuelles.
FLASHMODE_OFF L’appareil photo est configuré pour ne pas clignoter pour une image prise.
FLASHMODE_REDEYE_AUTO L’appareil photo détermine les paramètres de Flash appropriés à l’aide d’une réduction des yeux rouges, indépendamment des conditions d’éclairage actuelles.
FLASHMODE_REDEYE_FILL L’appareil photo est configuré pour utiliser la réduction des yeux rouges et les clignotements, indépendamment des conditions d’éclairage actuelles.
FLASHMODE_EXTERNALSYNC L’appareil photo est configuré pour se synchroniser avec des unités flash externes.

WIA_DPC_FOCUS_MODE
CameraDeviceFocusMode

Définit le paramètre de mode Focus actuel pour le périphérique de l’appareil photo. Le pilote de périphérique énumère les valeurs prises en charge de cette propriété. Une application écrit cette propriété pour définir le mode focus pour l’appareil photo.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_LIST

Le tableau suivant contient les trois constantes qui sont valides avec cette propriété.

Mode focus Description
FOCUSMODE_MANUAL L’appareil photo est configuré pour permettre à l’utilisateur de se concentrer manuellement.
FOCUSMODE_AUTO L’appareil photo est configuré pour se concentrer automatiquement.
FOCUSMODE_MACROAUTO L’appareil photo est configuré pour se concentrer automatiquement à l’aide des paramètres de macro de plage abrégée.

WIA_DPC_FOCUS_MANUAL_DIST

Réservé, n’utilisez pas.

Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE

WIA_DPC_ZOOM_POSITION

Réservé, n’utilisez pas.

Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE

WIA_DPC_PAN_POSITION
CameraDevicePanPosition

Réservé, n’utilisez pas.

Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE

WIA_DPC_TILT_POSITION
CameraDeviceTiltPosition

Réservé, n’utilisez pas.

Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE

WIA_DPC_TIMER_MODE
CameraDeviceTimerMode

Réservé, n’utilisez pas.

Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE

WIA_DPC_TIMER_VALUE
CameraDeviceTimerValue

Réservé, n’utilisez pas.

Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE

WIA_DPC_POWER_MODE
CameraDevicePowerMode

Définit la source d’alimentation actuelle pour l’appareil photo. Une application lit cette propriété pour déterminer la source d’alimentation utilisée par l’appareil photo.

Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE

Le tableau suivant contient les deux constantes qui sont valides avec cette propriété.

Mode d'alimentation Description
POWERMODE_LINE L’appareil photo fonctionne sur un adaptateur d’alimentation.
POWERMODE_BATTERY L’appareil photo fonctionne sur batterie.

WIA_DPC_BATTERY_STATUS
CameraDeviceBatteryStatus

Pourcentage de la puissance de la batterie restant pour le fonctionnement de l’appareil photo. Cette valeur doit être un entier compris entre 0 et 100. Une application lit cette propriété pour déterminer la durée de vie restante de la batterie de l’appareil photo.

Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE

WIA_DPC_THUMB_WIDTH
CameraDeviceThumbWidth

Largeur, en pixels, d’une image miniature à utiliser pour les images nouvellement capturées. Une application lit cette valeur pour obtenir une taille estimée pour l’affichage des miniatures dans son interface utilisateur.

Type : VT_I4, Access : lecture/écriture (WIA_PROP_LIST) ou lecture seule (WIA_PROP_NONE), valeurs valides : WIA_PROP_LIST ou WIA_PROP_NONE

WIA_DPC_THUMB_HEIGHT
CameraDeviceThumbHeight

Largeur, en pixels, d’une image miniature à utiliser pour les images nouvellement capturées. Une application lit cette valeur pour obtenir une taille estimée pour l’affichage des miniatures dans son interface utilisateur.

Type : VT_I4, Access : lecture/écriture (WIA_PROP_LIST) ou lecture seule (WIA_PROP_NONE), valeurs valides : WIA_PROP_LIST ou WIA_PROP_NONE

WIA_DPC_PICT_WIDTH
CameraDevicePictWidth

Largeur en pixels à utiliser pour les images nouvellement capturées. La liste des valeurs valides pour cette propriété a une correspondance un-à-un avec la liste des valeurs valides pour la propriété WIA_DPC_PICT_HEIGHT . Si la largeur et la hauteur individuelles sont définissables de manière linéaire et orthogonales les unes avec les autres, elles peuvent être exprimées sous la forme d’une plage.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE

WIA_DPC_PICT_HEIGHT
CameraDevicePictHeight

Hauteur en pixels à utiliser pour les images nouvellement capturées. La liste des valeurs valides pour cette propriété a une correspondance un-à-un avec la liste des valeurs valides pour la propriété WIA_DPC_PICT_WIDTH . Si la largeur et la hauteur individuelles sont définissables de manière linéaire et orthogonales les unes avec les autres, elles peuvent être exprimées sous la forme d’une plage.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE

WIA_DPC_DIMENSION

Réservé, n’utilisez pas.

Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE

WIA_DPC_COMPRESSION_SETTING
CameraDeviceCompressionSetting

Conçue pour être approximativement linéaire en ce qui concerne la qualité d’image perçue sur un large éventail de contenu de scène, elle contient une plage ou une liste d’entiers. Des entiers plus petits sont utilisés pour représenter une qualité inférieure (c’est-à-dire, une compression maximale), tandis que les entiers plus grands sont utilisés pour représenter une qualité supérieure (c’est-à-dire, compression minimale). Tous les paramètres disponibles sur un appareil sont relatifs uniquement à ce périphérique et sont donc spécifiques à l’appareil.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE

WIA_DPC_FOCUS_METERING

Réservé, n’utilisez pas.

Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE

WIA_DPC_TIMELAPSE_INTERVAL
CameraDeviceTimelapseInterval

Durée, en millisecondes, entre les captures d’images dans une opération de capture temporelle.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_NONE, WIA_PROP_LIST ou WIA_PROP_RANGE

WIA_DPC_TIMELAPSE_NUMBER
CameraDeviceTimelapseNumber

Nombre d’images que l’appareil tente de capturer pendant une capture temporelle.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_NONE, WIA_PROP_LIST ou WIA_PROP_RANGE

WIA_DPC_BURST_INTERVAL
CameraDeviceBurstInterval

Durée, en millisecondes, entre les captures d’images au cours d’une opération de rafale.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_NONE, WIA_PROP_LIST ou WIA_PROP_RANGE

WIA_DPC_BURST_NUMBER
CameraDeviceBurstNumber

Nombre d’images que l’appareil tente de capturer pendant une opération de rafale.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_NONE, WIA_PROP_LIST ou WIA_PROP_RANGE

WIA_DPC_EFFECT_MODE
CameraDeviceEffectMode

Spécifie le mode spécial d’acquisition d’image de l’appareil photo.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_LIST

Le tableau suivant contient les trois constantes qui sont valides avec cette propriété.

Mode d’effet Description
EFFECTMODE_STANDARD Capturez une image en mode standard pour l’appareil photo.
EFFECTMODE_BW Capturez une image en nuances de gris.
EFFECTMODE_SEPIA Capturez une image sépia.

WIA_DPC_DIGITAL_ZOOM
CameraDeviceDigitalZoom

Taux de zoom effectif de l’image acquise de l’appareil photo numérique, mis à l’échelle d’un facteur de 10. La valeur 10 correspond à l’absence de zoom numérique (1X), qui est la taille de scène standard capturée par l’appareil photo. La valeur 20 correspond à un zoom 2X, où un quart de la taille de la scène standard est capturé par l’appareil photo.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE

WIA_DPC_SHARPNESS
CameraDeviceSharpness

La netteté perçue d’une image capturée. Cette propriété peut utiliser une liste de valeurs ou une plage de valeurs. La valeur minimale représente le moins de précision, tandis que la valeur maximale représente la netteté maximale. En général, une valeur au milieu de la plage représente la netteté normale ou par défaut.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE

WIA_DPC_CONTRAST
CameraDeviceContrast

Contraste perçu d’une image capturée. Cette propriété peut contenir une liste de valeurs ou une plage de valeurs. La valeur minimale prise en charge représente le moins de contraste, tandis que la valeur maximale représente le contraste le plus élevé. En règle générale, une valeur au milieu de la plage représente le contraste normal ou par défaut.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE

WIA_DPC_CAPTURE_MODE
CameraDeviceCaptureMode

Définit le mode de capture de l’image.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_LIST

Le tableau suivant contient les trois constantes qui sont valides avec cette propriété.

Mode de capture Description
CAPTUREMODE_NORMAL Mode normal de l’appareil photo.
CAPTUREMODE_BURST Capturez plus d’une image en succession rapide, comme défini par les valeurs des propriétés WIA_DPC_BURST_NUMBER et WIA_DPC_BURST_INTERVAL .
CAPTUREMODE_TIMELAPSE Capturez plusieurs images successivement, comme défini par les propriétés WIA_DPC_TIMELAPSE_NUMBER et WIA_DPC_TIMELAPSE_INTERVAL .

WIA_DPC_CAPTURE_DELAY
CameraDeviceCaptureDelay

Valeur représentant le délai, en millisecondes, à insérer entre le déclencheur de capture et le lancement réel de la capture de données. Cette propriété n’est pas destinée à décrire le temps entre les frames pour une initialisation unique, plusieurs captures telles qu’une rafale ou un laps de temps, qui ont des propriétés d’intervalle distinctes WIA_DPC_BURST_INTERVAL et WIA_DPC_TIMELAPSE_INTERVAL. Dans ce cas, il sert toujours de délai initial avant la capture de la première image de la série, indépendamment du temps entre les frames. Pour aucun délai de précapture, cette propriété doit être définie sur zéro.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE

WIA_DPC_EXPOSURE_INDEX
CameraDeviceExposureIndex

Permet l’émulation des paramètres de vitesse de la pellicule sur un appareil photo numérique. Les paramètres correspondent aux désignations ISO (ASA/DIN). En règle générale, un appareil prend en charge des valeurs énumérées discrètes, mais le contrôle continu sur une plage de valeurs est possible. La valeur 0xFFFF correspond au paramètre ISO automatique.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE

WIA_DPC_EXPOSURE_METERING_MODE
CameraDeviceExposureMeteringMode

Spécifie le mode utilisé par l’appareil photo pour ajuster automatiquement le paramètre d’exposition.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_LIST

Mode de contrôle d’exposition Description
EXPOSUREMETERING_AVERAGE Définissez l’exposition en fonction de la moyenne de la scène entière.
EXPOSUREMETERING_CENTERWEIGHT Définissez l’exposition en fonction d’une moyenne pondérée au centre.
EXPOSUREMETERING_MULTISPOT Définissez l’exposition en fonction d’un modèle à points.
EXPOSUREMETERING_CENTERSPOT Définissez l’exposition en fonction d’une zone centrale.

WIA_DPC_FOCUS_METERING_MODE
CameraDeviceFocusMeteringMode

Spécifie le mode utilisé par l’appareil photo pour ajuster automatiquement le focus.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_LIST

Le tableau suivant contient les deux constantes qui sont valides avec cette propriété.

Mode de contrôle du focus Description
FOCUSMETERING_CENTERSPOT Ajustez le focus en fonction d’un point central.
FOCUSMETERING_MULTISPOT Ajustez le focus en fonction d’un modèle à points.

WIA_DPC_FOCUS_DISTANCE
CameraDeviceFocusDistance

Distance, en millimètres, entre le plan de capture d’image de l’appareil photo numérique et le point de focus. La valeur 0xFFFF correspond à un paramètre supérieur à 655 mètres.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE

WIA_DPC_FOCAL_LENGTH
CameraDeviceFocalLength

Longueur focale équivalente à 35mm. Les valeurs de cette propriété correspondent à la longueur focale, en millimètres, multipliée par 100. La longueur focale détermine le zoom optique.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_NONE

WIA_DPC_RGB_GAIN
CameraDeviceRGBGain

Chaîne Unicode terminée par le caractère null qui représente l’avantage rouge, vert et bleu appliqué aux données d’image, respectivement. Par exemple, " 4:25:50 " représente un gain rouge de 4, un gain vert de 25 et un gain bleu de 50.

Type : VT_BSTR, Access : lecture/écriture, valeurs valides : WIA_PROP_NONE

WIA_DPC_WHITE_BALANCE
CameraDeviceWhiteBalance

Spécifie la façon dont l’appareil photo numérique pèse les canaux de couleur.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_LIST

La liste suivante répertorie les valeurs possibles de cette propriété.

Équilibre des blancs Description
WHITEBALANCE_MANUAL L’équilibre des blancs est défini directement à l’aide de la propriété WIA_DPC_RGB_GAIN .
WHITEBALANCE_AUTO L’appareil photo utilise un mécanisme automatique pour définir l’équilibre du blanc.
WHITEBALANCE_ONEPUSH_AUTO L’appareil photo détermine le réglage de l’équilibre des blancs lorsqu’un utilisateur appuie sur le bouton de capture tout en pointant la caméra sur une surface blanche.
WHITEBALANCE_DAYLIGHT L’appareil photo définit l’équilibre des blancs sur une valeur appropriée pour une utilisation dans les conditions d’heure d’été.
WHITEBALANCE_FLORESCENT L’appareil photo définit l’équilibre des blancs sur une valeur appropriée pour une utilisation avec une source de lumière fluorescente.
WHITEBALANCE_TUNGSTEN L’appareil photo définit l’équilibre blanc sur une valeur appropriée pour une utilisation avec une source de lumière tungstène.
WHITEBALANCE_FLASH L’appareil photo définit l’équilibre des blancs sur une valeur appropriée pour une utilisation avec un Flash électronique.

WIA_DPC_UPLOAD_URL
CameraDeviceUploadURL

Décrit une URL. L’URL décrite par ce proroperty est l’une des images ou des objets qui, une fois qu’ils sont acquis à partir du périphérique, peuvent être téléchargés vers, conformément à l’un des scénarios suivants.

  • Une application WIA lit cette propriété et permet à l’utilisateur de télécharger automatiquement des images vers l’URL.
  • Une application définit l’URL et d’autres périphériques (bornes, etc.) utilisent cette propriété.

Microsoft Windows ne charge pas les images par lui-même.

Type : VT_BSTR, Access : lecture/écriture, valeurs valides : WIA_PROP_NONE

WIA_DPC_ARTIST
CameraDeviceArtist

Nom du propriétaire (qui est l’utilisateur actuel) de l’appareil. L’appareil utilise cette propriété pour remplir le champ Artist dans chaque image EXIF capturée.

Type : VT_BSTR, Access : lecture/écriture, valeurs valides : WIA_PROP_NONE

WIA_DPC_COPYRIGHT_INFO
CameraDeviceCopyrightInfo

Notification de droits d’auteur. L’appareil utilise cette propriété pour renseigner le champ de copyright dans chaque image EXIF capturée.

Type : VT_BSTR, Access : lecture/écriture, valeurs valides : WIA_PROP_NONE

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professional, Windows XP [ desktop apps uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
En-tête
Wiadef. h