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 | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
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 |
||||||||||||||||
|
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 |
||||||||||||||||
|
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é.
|
||||||||||||||||
|
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 |
||||||||||||||||
|
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 |
||||||||||||||||
|
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 |
||||||||||||||||
|
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é.
|
||||||||||||||||
|
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é.
|
||||||||||||||||
|
Réservé, n’utilisez pas. Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Réservé, n’utilisez pas. Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Réservé, n’utilisez pas. Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Réservé, n’utilisez pas. Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Réservé, n’utilisez pas. Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Réservé, n’utilisez pas. Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
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é.
|
||||||||||||||||
|
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 |
||||||||||||||||
|
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 |
||||||||||||||||
|
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 |
||||||||||||||||
|
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 |
||||||||||||||||
|
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 |
||||||||||||||||
|
Réservé, n’utilisez pas. Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
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 |
||||||||||||||||
|
Réservé, n’utilisez pas. Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
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 |
||||||||||||||||
|
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 |
||||||||||||||||
|
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 |
||||||||||||||||
|
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 |
||||||||||||||||
|
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é.
|
||||||||||||||||
|
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 |
||||||||||||||||
|
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 |
||||||||||||||||
|
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 |
||||||||||||||||
|
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é.
|
||||||||||||||||
|
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 |
||||||||||||||||
|
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 |
||||||||||||||||
|
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
|
||||||||||||||||
|
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é.
|
||||||||||||||||
|
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 |
||||||||||||||||
|
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 |
||||||||||||||||
|
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 |
||||||||||||||||
|
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é.
|
||||||||||||||||
|
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.
Microsoft Windows ne charge pas les images par lui-même. Type : VT_BSTR, Access : lecture/écriture, valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
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 |
||||||||||||||||
|
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 |
|