Constantes de propriété d’élément WIA courantes
Les constantes de propriété d’appareil suivantes doivent être prises en charge par toutes les interfaces IWiaItem, IWiaItem2 et IWiaDrvItem, sauf indication contraire dans leurs descriptions.
Le préfixe « WIA_IPA_ » indique une propriété d’élément pour tous les appareils et est la convention d’affectation de noms utilisée dans C/C++. À des fins de script, ces constantes utilisent le préfixe « Picture » 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 la constante C/C++ dans la liste suivante.
| Constante/valeur | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Cet indicateur contrôle l’accès à l’élément et détermine si l’élément est supprimé. Obligatoire pour tous les éléments WIA 2.0. Type : VT_I4; En lecture/écriture ou en lecture seule, en fonction de la capacité de l’élément à voir ses droits d’accès modifiés ; Valeurs valides : WIA_PROP_FLAG Le tableau suivant contient les cinq indicateurs valides avec cette propriété.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Cette propriété est réservée par pour une utilisation ultérieure et n’est pas implémentée pour l’instant. Type : VT_I4, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contient le nombre de bits par canal pour l’image. Le minidriver crée et gère cette propriété. Obligatoire pour tous les éléments d’image stockés ou activés pour l’acquisition WIA 2.0. Type : VT_I4, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contient la taille de la mémoire tampon, en octets, utilisée lors d’un transfert de données. Le minidriver crée et gère cette propriété. Une application peut lire cette propriété pour déterminer la taille de mémoire tampon spécifiée par le pilote pour les transferts de données. Le service WIA lit également cette propriété pour allouer de la mémoire au minidriver pendant le transfert de données Facultatif pour tous les éléments WIA 2.0 activés pour le transfert. Type : VT_I4, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE
Remarque : |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contient le nombre d’octets dans une ligne de balayage de l’image. Le minidriver crée et gère cette propriété. Facultatif pour tous les éléments WIA 2.0. Type : VT_I4, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contient le nombre de canaux par pixel pour l’image. Le minidriver crée et gère cette propriété. Obligatoire pour tous les éléments d’image stockés ou activés pour l’acquisition WIA 2.0. Type : VT_I4, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Cette propriété est réservée par pour une utilisation ultérieure et n’est pas implémentée pour l’instant. Type : VT_I4, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contient le type de compression actuel utilisé. Le minidriver crée et gère cette propriété. Une application lit cette propriété pour déterminer le type de compression d’image ou définit cette propriété pour configurer le paramètre de compression. Type : VT_I4, Accès : Lecture/écriture, Valeurs valides : WIA_PROP_LIST Le tableau suivant contient les constantes valides avec cette propriété. Le symbole V indique que la constante est prise en charge uniquement dans Windows Vista et versions ultérieures. (Il est disponible uniquement via l’interface IWiaItem2 .)
[!Note] Lorsque cette propriété est WIA_COMPRESSION_NONE et que WIA_IPA_FORMAT est WiaImgFmt_PDFA ou WiaImgFmt_XPS ; ensuite, WIA_COMPRESSION_NONE signifie que le mode de compression n’est pas défini et que le scanneur doit décider d’un mode. WIA_COMPRESSION_AUTO est une nouvelle valeur de propriété définie pour la propriété WIA_IPA_COMPRESSION. Cette valeur est valide pour tous les éléments de source de données d’image programmables, y compris le lit plat et le chargeur. Lorsque cette valeur est prise en charge par le mini-pilote WIA, le client d’application WIA peut définir WIA_IPA_COMPRESSION afin d’activer la détection automatique du mode de compression sur l’appareil. WIA_COMPRESSION_AUTO peut fonctionner avec et sans prise en charge ou activation de la couleur automatique complète (WIA_DATA_AUTO et WIA_DEPTH_AUTO). WIA_COMPRESSION_AUTO est particulièrement utile avec les formats de fichiers de transfert qui prennent en charge plusieurs types de données et profondeurs de bits, tels que les WiaImgFmt_RAW. Pour plus d’informations sur les formats de fichiers de transfert, consultez WIA_IPA_FORMAT dans ce tableau. Il est opitonal pour le mini-pilote WIA de suporter WIA_COMPRESSION_AUTO. Lorsqu’il est pris en charge, le mini-pilote WIA ne doit jamais le définir comme valeur par défaut pour WIA_IPA_COMPRESSION ; seule l’application WIA peut définir cette valeur. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contient le paramètre de type de données actuel pour l’appareil. Le minidriver crée et gère cette propriété. Une application lit cette propriété pour déterminer le type de données de l’image. Une application écrit cette propriété pour définir le type de données actuel de l’image sur le point d’être transférée. Cette propriété est requise pour tous les éléments WIA 2.0. Il doit être en lecture/écriture pour tous les éléments avec acquisition WIA 2.0 et En lecture seule pour les éléments de stockage WIA 2.0. Type : VT_I4 ; Accès pour les systèmes d’exploitation antérieurs à Windows Vista : cette propriété est En lecture seule pour les caméras et en lecture/écriture pour les scanneurs ; Accès pour Windows Vista et versions ultérieures : cette propriété est en lecture seule pour les éléments WIA_CATEGORY_FOLDER et WIA_CATEGORY_FINISHED_FILE, et en lecture/écriture pour toutes les autres catégories d’éléments WIA 2.0 ; Valeurs valides : WIA_PROP_LIST Le tableau suivant contient les six constantes valides avec lorsque WIA_IPA_FORMAT n’est pas défini sur WiaImgFmt_RAW.
La propriété WIA_IPA_DATATYPE est également utilisée pour décrire le type de transfert de données RAW à utiliser lorsque l’application définit WiaImgFmt_RAW. Le pilote doit définir la propriété WIA_IPA_DATATYPE sur une liste de valeurs autorisées à partir desquelles l’application peut en choisir une. Si l’appareil ne peut être défini sur qu’une seule valeur, créez un type WIA_PROP_LIST et placez-y la valeur valide. Vérifiez la propriété WIA_IPA_DEPTH pour déterminer la profondeur des bits. Cette propriété contient généralement une seule valeur pour les caméras. Le tableau suivant répertorie les constantes valides avec WIA_IPA_DATATYPE lorsque WIA_IPA_FORMAT est défini sur WiaImgFmt_RAW.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
WIA_IPA_DEPTH Contient le paramètre de profondeur de bits d’une image. Le minidriver crée et gère cette propriété. Une application lit cette propriété pour déterminer le paramètre de profondeur de bits de l’image. L’application peut également définir cette valeur sur la profondeur de bits souhaitée. Si l’appareil ne peut être défini sur qu’une seule valeur, créez un type WIA_PROP_LIST et placez-y la valeur valide. Cette propriété est requise pour tous les éléments WIA 2.0. Il doit être en lecture/écriture pour tous les éléments avec acquisition WIA 2.0 et En lecture seule pour les éléments de stockage WIA 2.0. Type : VT_I4 ; Accès pour les systèmes d’exploitation antérieurs à Windows Vista : lecture/écriture ; Accès pour Windows Vista et versions ultérieures : cette propriété est en lecture seule pour les éléments WIA_CATEGORY_FOLDER et WIA_CATEGORY_FINISHED_FILE, et en lecture/écriture pour toutes les autres catégories d’éléments WIA 2.0 ; Valeurs valides : WIA_PROP_LIST WIA_DEPTH_AUTO est défini comme 0 bits par pixel, et il s’agit d’une nouvelle valeur de propriété définie pour le WIA_IPA_DEPTH. Cette valeur est valide pour tous les éléments de source de données d’image programmables, y compris le lit plat et le chargeur. Lorsque WIA_DEPTH_AUTO est pris en charge par le mini-pilote WIA, le client d’application WIA peut définir WIA_IPA_DEPTH sur cette valeur pour activer la détection automatique des couleurs sur l’appareil. Lorsque WIA_DEPTH_AUTO est défini, le mini-pilote WIA doit mettre à jour WIA_IPA_DATATYPE sur le même élément pour WIA_DATA_AUTO (qui doit être une valeur prise en charge, si l’appareil prend en charge la couleur automatique). WIA_DEPTH_AUTO est une valeur facultative, mais elle devient obligatoire lorsque WIA_DATA_AUTO est pris en charge pour WIA_IPA_DATATYPE. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contient l’extension de nom de fichier pour un format de fichier particulier. Le minidriver crée et gère cette propriété. Facultatif pour tous les éléments WIA 2.0 avec transfert. Type : VT_BSTR, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE Le pilote met à jour cette propriété pour refléter la valeur actuelle de la propriété WIA_IPA_FORMAT . Par exemple, si WIA_IPA_FORMAT est WiaImgFmt_JPEG, WIA_IPA_FILENAME_EXTENSION doit être jpg. Si WIA_IPA_FORMAT est WiaImgFmt_BMP, WIA_IPA_FILENAME_EXTENSION doit être BMP.
Remarque : Cette propriété est recommandée pour les pilotes qui prennent en charge les formats standard et est requise pour les pilotes qui implémentent des formats personnalisés. Il informe l’application de l’extension de nom de fichier appropriée à utiliser lors du transfert de fichiers au format privé. Par exemple, si A. Datum Corporation a créé un pilote WIA qui a transféré un fichier dans un nouveau format, l’entreprise peut spécifier une extension de « adc ». Cela permet aux applications de transférer des données dans ce format vers un fichier et de créer un nom de fichier tel que myfile.adc, ce qui est utile pour d’autres personnes qui comprennent la nouvelle extension. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contient le format actuel de l’image sur le point d’être transférée. Une application lit cette propriété pour déterminer le format de l’image qu’elle est sur le point de recevoir. Une application écrit cette propriété pour définir le format. Cette propriété dépend de la propriété WIA_IPA_TYMED . Le minidriver crée et gère cette propriété. Si l’appareil ne peut être défini sur qu’une seule valeur, créez un type WIA_PROP_LIST et placez-y la valeur valide. Type : CLSID, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST Le tableau suivant répertorie les constantes valides avec cette propriété. L’astérisque * indique que la constante n’est pas prise en charge dans Windows Vista. (Il est disponible uniquement via l’interface IWiaItem .) Le double astérisque ** indique que la constante n’est pas prise en charge dans Windows Server 2003 ou Windows Vista. Le symbole V indique que la constante est prise en charge uniquement dans Windows Vista et versions ultérieures. (Il est disponible uniquement via l’interface IWiaItem2 .)
Remarque : |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contient le nom complet de l’élément (le nom de l’élément avec les informations de chemin d’accès). Le nom complet de l’élément est identique au paramètre bstrFullItemName de la fonction utilitaire de service wiasCreateDrvItem . Une application lit cette propriété pour déterminer l’élément qu’elle utilise actuellement et où cet élément se trouve dans l’arborescence de l’élément. Chaque élément doit avoir un nom unique. Les applications utilisent généralement le nom complet de l’élément pour rechercher des éléments dans l’arborescence d’éléments. Le service WIA crée et gère cette propriété. Obligatoire pour tous les éléments WIA 2.0. Type : VT_BSTR, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Cette propriété est réservée à une utilisation ultérieure et n’est pas implémentée pour l’instant. Type : VT_I4, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contient le nom de profil ICM nécessaire pour décoder correctement l’image. Une application lit cette propriété pour déterminer le profil ICM à utiliser lors du traitement de l’image. Le service WIA crée et gère cette propriété en fonction de l’entrée ICMProfiles dans le fichier d’installation du pilote. Type : VT_BSTR, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Pris en charge uniquement dans Windows Vista et versions ultérieures. Les éléments WIA 2.0 sont regroupés en catégories qui définissent comment un IWiaItem2 doit être traité ou utilisé. Par exemple, si l’élément représente un chargeur, l’application doit s’attendre à ce qu’il contienne les propriétés requises du chargeur de documents et fonctionne comme un chargeur de documents. Si l’élément représente un fichier terminé, une application WIA 2.0 doit le traiter de cette façon, en supposant que les données sont statiques et se trouvent sur l’appareil. (Les règles de chaque élément seront définies dans leurs documents de spécification individuels.) Obligatoire pour tous les éléments WIA 2.0. Type : VT_CLSID, Accès : Lecture seule, Valeurs valides : GUID de catégorie d’élément |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contient les indicateurs descriptifs d’un élément WIA. Les indicateurs d’élément sont les mêmes que ceux du paramètre lObjectFlags de la fonction utilitaire de service wiasCreateDrvItem . Le service WIA crée et gère cette propriété. Une application lit cette propriété pour déterminer les valeurs d’indicateur descriptif de l’élément. Type : VT_I4 Access : Lecture seule, Valeurs valides : WIA_PROP_NONE Le tableau suivant contient les indicateurs valides avec cette propriété. Un astérisque * indique que l’indicateur n’est pas pris en charge dans Windows Vista ou version ultérieure. (Il est uniquement disponible via l’interface IWiaItem .) Un double astérisque ** indique que l’indicateur n’est pas pris en charge dans Windows Server 2003 ou Windows Vista ou version ultérieure. Le symbole V indique que l’indicateur est pris en charge uniquement dans Windows Vista et versions ultérieures. (Il est disponible uniquement via l’interface IWiaItem2 .)
Certains de ces indicateurs sont obligatoires ou facultatifs pour les éléments WIA 2.0, en fonction de la catégorie de l’élément, comme indiqué dans ce tableau.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contient le nom de l’élément. Une application lit cette propriété pour déterminer l’élément qu’elle utilise actuellement. Chaque élément a un nom unique. Le service WIA crée et gère cette propriété. Obligatoire pour tous les éléments WIA 2.0. Type : VT_BSTR, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contient la taille actuelle, en octets, des données associées à l’élément. Le minidriver crée et gère cette propriété. Contient la taille totale des données transférées. Si cette valeur est égale à zéro, cela signifie que le minidriver n’a aucune information sur la taille exacte des données. (Ceci est courant pour les données compressées.) Une application lit cette valeur pour déterminer la taille de l’acquisition avant qu’elle n’ait lieu. Le service WIA lit cette propriété pour faciliter l’allocation de mémoire pour les transferts de données. Pour plus d’informations, consultez Transfert de données vers une application WIA si la propriété est définie sur zéro et que TYMED est configuré pour un transfert de fichiers, que le service WIA n’alloue pas de mémoire pour le minidriver WIA. Obligatoire pour tous les éléments WIA 2.0 activés pour le transfert. Type : VT_I4, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contient l’heure à laquelle l’image a été capturée à l’origine. Le minidriver crée et gère cette propriété. Cette propriété doit être signalée en tant que vecteur de huit valeurs WORD sous la forme d’une structure SYSTEMTIME (décrite dans la documentation du Kit de développement logiciel (SDK) de plateforme. Facultatif pour tous les éléments WIA 2.0. Type : VT_UI2 | accès VT_VECTOR : lecture/écriture ou lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Pris en charge uniquement dans Windows Vista et versions ultérieures. Spécifie le nombre d’éléments stockés dans l’élément WIA_CATEGORY_FOLDER. Type : VT_I4, Accès : Lecture/écriture, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Spécifie la taille de mémoire tampon minimale utilisée dans les transferts de données. Si le transfert de données est effectué via un mécanisme de rappel, la valeur de la propriété peut être aussi petite que 64 Ko. Toutefois, si le transfert se fait vers un fichier, la valeur de la propriété est le nombre d’octets nécessaires pour transférer une page de données à la fois. Le minidriver crée et gère cette propriété WIA. Facultatif pour tous les éléments WIA 2.0 activés pour le transfert. Type : VT_I4, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contient le nombre de lignes contenues dans l’image (la hauteur verticale de l’image en pixels). Le minidriver crée et gère cette propriété. Facultatif pour tous les éléments WIA 2.0. Type : VT_I4, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contient le nombre de pixels dans chaque ligne de l’image (la largeur de l’image en pixels). Le minidriver crée et gère cette propriété. Facultatif pour tous les éléments WIA 2.0. Type : VT_I4, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Cette propriété n’est pas prise en charge dans Windows Vista et versions ultérieures. Contient les options d’empaquetage des données d’image. Le minidriver crée et gère cette propriété. Une application lit cette propriété pour déterminer les options d’empaquetage d’images ou définit les options de compression d’images actuelles. Type : VT_I4; Accès : lecture/écriture ; Valeurs valides : WIA_PROP_LIST. Si l’appareil ne peut être défini sur qu’une seule valeur, créez un type WIA_PROP_LIST et placez-y la valeur valide. Le tableau suivant contient les deux constantes valides avec cette propriété.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contient le format préféré pour les images transférées par ce minidriver. Le minidriver crée et gère cette propriété. Obligatoire pour tous les éléments WIA 2.0 avec transfert. Type : CLSID, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Spécifie un CLSID qui représente un ensemble de valeurs de propriété d’appareil. Si un pilote de périphérique implémente cette fonctionnalité, les applications utilisent cette propriété pour déterminer si l’appareil prend en charge un ensemble de valeurs. Type : CLSID, Access : Lecture seule, Valeurs valides : WIA_PROP_LIST Le tableau suivant contient les 12 constantes valides avec cette propriété.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Pris en charge uniquement dans Windows Vista et versions ultérieures. Contient le nombre de bits dans chaque canal. Cette propriété doit être signalée en tant que vecteur d’autant de valeurs BYTE qu’il existe de canaux, où le premier BYTE correspond au nombre de bits dans le premier canal, le deuxième octet au nombre de bits dans le deuxième canal, et ainsi de suite. Il doit y avoir autant d’entrées qu’il y a de canaux en fonction de WIA_IPA_CHANNELS_PER_PIXEL. Le pilote définit cette propriété lorsque l’application bascule vers WiaImgFmt_RAW. Pour les sous-types bien connus, il existe autant d’entrées que celles répertoriées dans le tableau sous WIA_IPA_RAW_SUBTYPE. Type : VT_UI1|VT_VECTOR, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Cette propriété est réservée par pour une utilisation ultérieure et n’est pas implémentée pour le moment. Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Spécifie s’il faut supprimer les pages de propriétés générales pour les éléments sur l’appareil. Cette propriété est disponible sur Windows XP et versions ultérieures. Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE Le tableau suivant contient les constantes qui sont valides avec cette propriété. L’astérisque * indique que la constante n’est pas valide avec Windows Vista et versions ultérieures. (Il est disponible uniquement via l’interface IWiaItem .)
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Cette propriété contient le paramètre de méthode de transfert. Le minidriver crée et gère cette propriété. Une application lit cette propriété pour déterminer la méthode de transfert de données du minidriver. Obligatoire pour tous les éléments WIA 2.0 avec transfert. Type : VT_I4, Accès : Lecture/écriture, Valeurs valides : WIA_PROP_LIST Le tableau suivant contient les constantes qui sont valides avec cette propriété. L’astérisque * indique les constantes qui ne sont pas valides avec Windows Vista et versions ultérieures. (Ils sont disponibles uniquement via l’interface IWiaItem .)
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Pris en charge uniquement dans Windows Vista et versions ultérieures. Spécifie le nombre d’octets à charger pour un élément. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_NONE |
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2008 [applications de bureau uniquement] |
| En-tête |
|