Partager via

Constantes de propriété d’élément WIA du scanneur

  • Article

Les constantes suivantes spécifient l’ensemble valide des propriétés d’élément du scanneur d’acquisition d’images Windows (WIA).

Le préfixe « WIA_IPS_ » indique une propriété Item pour les appareils scanneurs et correspond à la convention de nommage utilisée en C/C++. À des fins de script, ces constantes utilisent le préfixe « ScannerPicture » et font partie du type énuméré WiaItemPropertyId . Le nom de membre correspondant de cette énumération de script apparaît entre parenthèses en regard du nom de la constante C/C++ dans la liste suivante.

Constante/valeur Description
WIA_IPS_AUTO_DESKEW
ScannerPictureAutoDeskew
 Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.


Active ou désactive automatiquement le bureau.
Facultatif pour WIA_CATEGORY_FEEDER uniquement.
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é.

Constant Description
WIA_AUTO_DESKEW_ON Activez le bureau automatique.
WIA_AUTO_DESKEW_OFF Désactiver le bureau automatique.

 
WIA_IPS_BRIGHTNESS
ScannerPictureBrightness

Valeurs de luminosité d’image disponibles dans le scanneur.

Contient le paramètre de luminosité matérielle actuel pour l’appareil. Une application définit cette propriété sur la valeur de luminosité du matériel. Le minidriver crée et gère cette propriété.

Les valeurs doivent être mappées dans une plage comprise entre -1000 et 1000, où 1000 correspond à la luminosité maximale, 0 correspond à la luminosité normale et -1000 correspond à la luminosité minimale.

Obligatoire pour tous les éléments des catégories : WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK et WIA_CATEGORY_FILM. Facultatif, mais recommandé, pour les éléments WIA_CATEGORY_FINISHED_FILE prenant en charge les préversions.

Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_RANGE
WIA_IPS_CONTRAST
ScannerPictureContrast

Contient le paramètre de contraste matériel actuel pour un appareil. Une application définit cette propriété sur la valeur de contraste du matériel. Le minidriver crée et gère cette propriété.

Les valeurs doivent être mappées dans une plage comprise entre -1000 et 1000, où -1000 correspond au contraste minimal, 0 correspond au contraste normal et 1000 correspond au contraste maximal.

Obligatoire pour tous les éléments des catégories : WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK et WIA_CATEGORY_FILM. Facultatif, mais recommandé, pour les éléments WIA_CATEGORY_FINISHED_FILE prenant en charge les préversions.

Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_RANGE
WIA_IPS_CUR_INTENT
ScannerPictureCurIntent

Contient les paramètres d’intention actuels. Le minidriver crée et gère cette propriété.

Obligatoire pour tous les éléments activés pour l’acquisition ; c’est-à-dire les éléments des catégories : WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK et WIA_CATEGORY_FILM. Il n’est pas pris en charge pour les éléments WIA_CATEGORY_FINISHED_FILE ou WIA_CATEGORY_FOLDER.

Type : VT_I4 Access : Lecture/écriture, Valeurs valides : WIA_PROP_FLAGS

Le pilote les utilise pour prédéfinir les propriétés d’élément en fonction de l’utilisation prévue de l’image par une application. Cela peut inclure, par exemple, la qualité maximale, la taille minimale, etc.

Le pilote choisit la profondeur de bits, en points par pouce, et d’autres paramètres qu’il détermine sont appropriés pour l’intention sélectionnée. Il incombe à l’application de lire les paramètres actuels pour déterminer les propriétés qui ont été modifiées. Une application définit cette propriété pour définir automatiquement les propriétés WIA pour une intention d’acquisition spécifique. Cette propriété est requise pour tous les scanneurs.

Une application définit cette propriété pour définir automatiquement les propriétés WIA pour une intention d’acquisition spécifique

Remarque :
Les indicateurs peuvent être combinés avec un opérateur OR au niveau du bit, mais une image ne peut pas être à la fois en nuances de gris et en couleur.

 

Cette propriété est requise pour tous les scanneurs.

Le tableau suivant contient les indicateurs de type image et leurs définitions. Ces indicateurs sont utilisés pour définir le type d’image prévu : couleur, nuances de gris, etc.

Indicateurs de type d’image prévus Description
WIA_INTENT_NONE Valeur par défaut. Aucune intention n’est spécifiée.
WIA_INTENT_IMAGE_TYPE_COLOR L’application a l’intention de préparer l’appareil pour une analyse des couleurs.
WIA_INTENT_IMAGE_TYPE_GRAYSCALE L’application a l’intention de préparer l’appareil pour une analyse de nuances de gris.
WIA_INTENT_IMAGE_TYPE_TEXT L’application a l’intention de préparer l’appareil pour l’analyse du texte.
WIA_INTENT_IMAGE_TYPE_MASK Masque pour tous les indicateurs de type image.

 

Le tableau suivant contient les indicateurs de qualité et de taille et leurs définitions. Ces indicateurs sont utilisés pour définir le niveau de qualité prévu.

Indicateurs de taille/qualité d’image prévus Description
WIA_INTENT_MINIMIZE_SIZE L’application a l’intention de préparer l’appareil pour l’analyse d’une image qui aboutit à une petite analyse.
WIA_INTENT_MAXIMIZE_QUALITY L’application a l’intention de préparer l’appareil pour l’analyse d’une image de haute qualité.
WIA_INTENT_SIZE_MASK Cet indicateur est un masque pour tous les indicateurs de taille/qualité.
WIA_INTENT_BEST_PREVIEW L’application a l’intention de préparer l’appareil pour l’analyse d’une préversion.

 
WIA_IPS_DESKEW_X
ScannerPictureDeskewX

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Contient le nombre de pixels dans la direction X de WIA_IPS_XPOS à la coordonnée x du coin supérieur de l’image à mettre en place. Par conséquent, il décrit, conjointement avec WIA_IPS_DESKEW_Y, où les deux coins supérieurs de l’image asymétrique se trouvent dans le rectangle englobant défini par WIA_IPS_XPOS, WIA_IPS_YPOS, WIA_IPS_XEXTENT et WIA_IPS_YEXTENT. sa propriété est implémentée par le pilote du scanneur s’il prend en charge la deskewing.

Les valeurs valides pour WIA_IPS_DESKEW_X doivent être comprises entre 0 et (WIA_IPS_XEXTENT - 1). La valeur 0 signifie qu’aucun travail ne doit être effectué.

Cette propriété est facultative pour les éléments des catégories WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER et WIA_CATEGORY_FILM ; et il n’est pas disponible pour les éléments WIA_CATEGORY_FINISHED_FILE ou WIA_CATEGORY_FOLDER.

Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_RANGE
WIA_IPS_DESKEW_Y
ScannerPictureDeskewY

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Contient le nombre de pixels dans la direction y entre WIA_IPS_YPOS et la coordonnée y du coin le plus à gauche de l’image à prendre en charge. Par conséquent, il décrit, conjointement avec WIA_IPS_DESKEW_X, où les deux coins supérieurs de l’image asymétrique se trouvent dans le rectangle englobant défini par WIA_IPS_XPOS, WIA_IPS_YPOS, WIA_IPS_XEXTENT et WIA_IPS_YEXTENT. Cette propriété est implémentée par le pilote du scanneur s’il prend en charge le deskewing.

Les valeurs valides pour WIA_IPS_DESKEW_Y doivent être comprises entre 0 et (WIA_IPS_YEXTENT - 1). La valeur 0 signifie qu’aucun travail ne doit être effectué.

Cette propriété est facultative pour les éléments des catégories WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER et WIA_CATEGORY_FILM ; et il n’est pas disponible pour les éléments WIA_CATEGORY_FINISHED_FILE ou WIA_CATEGORY_FOLDER.

Type : VT_I4, Accès : Lecture/écriture, Valeurs valides : WIA_PROP_RANGE
WIA_IPS_DOCUMENT_HANDLING_SELECT
ScannerPictureDocumentHandlingSelect

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Contient la source et le mode d’acquisition du scanneur actuels. Le minidriver crée et gère cette propriété.

Une application lit cette propriété pour déterminer la source d’acquisition actuelle du scanneur ou pour écrire cette propriété pour définir la source et le mode du scanneur. En outre, les applications utilisent cette propriété pour activer et désactiver les fonctionnalités du duplexeur.

Type : VT_I4, Accès : Lecture/écriture, Valeurs valides : WIA_PROP_FLAG

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

Indicateurs Description
DUPLEX Analyser à l’aide d’opérations de duplexeur. Analysez les deux côtés du document à l’aide des paramètres courants configurés pour l’élément de chargeur (WIA_CATEGORY_FEEDER). Duplex et ADVANCE_DUPLEX ne peuvent pas être définis.
ADVANCED_DUPLEX Analysez à l’aide de paramètres individuels configurés pour chaque élément d’alimentation enfant (WIA_CATEGORY_FEEDER_FRONT et WIA_CATEGORY_FEEDER_BACK). Duplex et ADVANCE_DUPLEX ne peuvent pas être définis.
FRONT_FIRST Scannez d’abord l’avant du document. Cette valeur est valide lorsque DUPLEX ou ADVANCED_DUPLEX est défini.
BACK_FIRST Commencez par analyser l’arrière du document. Cette valeur est valide lorsque DUPLEX ou ADVANCED_DUPLEX est défini.
FRONT_ONLY Analysez le devant uniquement.
BACK_ONLY Analysez l’arrière uniquement. Cette valeur est valide lorsque DUPLEX ou ADVANCED_DUPLEX est défini.

 
WIA_IPS_FILM_NODE_NAME
ScannerPictureFilmNodeName

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Active la spécification d’une pièce jointe de numérisation de film particulière lorsqu’il y en a plusieurs.

Cette propriété est requise pour les éléments WIA_CATEGORY_FILM lorsqu’il existe plusieurs éléments de numérisation de film. Si l’appareil ne prend en charge qu’un seul élément de film du scanneur racine, cette propriété est facultative.

Type : VT_BSTR, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE

Valeurs autorisées : le BSTR doit être sous la forme de @ResourceBinary,-<ResourceID> pour permettre la localisation, car cette chaîne serait exposée à l’utilisateur via l’interface utilisateur de numérisation de film.
WIA_IPS_FILM_SCAN_MODE
ScannerPictureFilmScanMode

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Active la configuration de l’analyse du film en cours.

Cette propriété est requise pour l’élément WIA_CATEGORY_FILM.

Type : VT_I4, Accès : Lecture/écriture, Valeurs valides : WIA_PROP_LIST

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

Constant Description
WIA_FILM_COLOR_SLIDE Recherchez une diapositive de couleur.
WIA_FILM_COLOR_NEGATIVE Recherchez un négatif de couleur.
WIA_FILM_BW_NEGATIVE Recherchez un négatif noir et blanc.

 
WIA_IPS_INVERT
ScannerPictureInvert

Réservé pour une utilisation ultérieure et n’est pas implémenté pour l’instant.

Type : VT_I4, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE
WIA_IPA_ITEMS_STORED
ScannerPictureInvert

Remarque :
Cette propriété est prise en charge uniquement par 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 seule, Valeurs valides : WIA_PROP_NONE
WIA_IPS_LAMP
ScannerPictureLamp

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Active ou désactive la lampe du scanneur.

Facultatif pour les éléments WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER et WIA_CATEGORY_FILM et recommandé pour les WIA_CATEGORY_FILM.

Type : VT_I4, Accès : Lecture/écriture, Valeurs valides : WIA_PROP_LIST

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

Constant Description
WIA_LAMP_ON Allumez la lampe.
WIA_LAMP_OFF Éteignez la lampe.

 
WIA_IPS_LAMP_AUTO_OFF
ScannerPictureLampAutoOff

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Définit la durée maximale pendant laquelle la lampe reste allumée lorsque le scanneur n’est pas utilisé.

Facultatif pour les éléments WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER et WIA_CATEGORY_FILM et recommandé pour les WIA_CATEGORY_FILM.

Type : VT_UI4, Accès : Lecture/écriture, Valeurs valides : 0 - 0xFFF secondes
WIA_IPS_MAX_HORIZONTAL_SIZE
ScannerPictureMaxHorizontalSize

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Spécifie la largeur maximale, en millièmes de pouce, analysée dans l’axe horizontal (X) à la résolution actuelle. Il peut s’agir de la largeur du chargeur de feuilles ou du lit de balayage, selon le type d’élément.

Type : VT_I4, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE
WIA_IPS_MAX_VERTICAL_SIZE
ScannerPictureMaxVerticalSize

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Spécifie la hauteur maximale, en millièmes de pouce, qui est analysée dans l’axe vertical (Y) à la résolution actuelle. Il peut s’agir de la hauteur du chargeur de feuilles ou du lit de balayage, selon le type d’élément.

Type : VT_I4, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE
WIA_IPS_MIN_HORIZONTAL_SIZE
ScannerPictureMinHorizontalSize

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Spécifie la largeur minimale, en millièmes d’un pouce, qui est analysée dans l’axe horizontal (X) à la résolution actuelle.

Type : VT_I4, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE
WIA_IPS_MIN_VERTICAL_SIZE
ScannerPictureMinVerticalSize

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Spécifie la hauteur minimale, en millièmes de pouce, qui est analysée dans l’axe vertical (Y) à la résolution actuelle.

Type : VT_I4, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE
WIA_IPS_MIRROR
ScannerPictureMirror

Réservé pour une utilisation ultérieure et n’est pas implémenté pour l’instant.

Type : VT_I4, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE
WIA_IPS_OPTICAL_XRES
ScannerPictureOpticalXres

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Résolution optique horizontale. Résolution optique horizontale la plus élevée prise en charge en PPP. Cette propriété est une valeur unique. Il ne s’agit pas d’une liste de toutes les résolutions pouvant être générées par l’appareil. Il s’agit plutôt de la résolution de l’optique de l’appareil. Le minidriver crée et gère cette propriété. Cette propriété est requise pour tous les éléments.

Type : VT_I4, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE
WIA_IPS_OPTICAL_YRES
ScannerPictureOpticalYres

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Résolution optique verticale. Résolution optique verticale la plus élevée prise en charge en PPP. Cette propriété est une valeur unique. Il ne s’agit pas d’une liste de toutes les résolutions générées par l’appareil. Il s’agit plutôt de la résolution de l’optique de l’appareil. Le minidriver crée et gère cette propriété. Cette propriété est requise pour tous les éléments.

Type : VT_I4, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE
WIA_IPS_ORIENTATION
ScannerPictureOrientation

Spécifie l’orientation actuelle des documents à analyser. Le minidriver crée et gère cette propriété.

Une application définit cette propriété pour définir l’orientation d’origine d’une page ou d’une image à acquérir. Pour plus d’informations sur l’utilisation de WIA_IPS_ORIENTATION, consultez WIA_IPS_PAGE_SIZE.

Remarque :
WIA_IPS_ORIENTATION fait référence à la position du document à analyser sur le lit ou le chargeur du scanneur. Il s’agit de l’orientation du document par rapport à la direction de l’analyse. WIA_IPS_ROTATION fait référence à la rotation appliquée à l’image après son analyse, juste avant le transfert de l’image vers l’application.

 

Type : VT_I4, Accès : Lecture/écriture, Valeurs valides : WIA_PROP_LIST

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

Valeur Définition
PORTRAIT 0 degré.
PAYSAGE Rotation de 90 degrés dans le sens inverse des aiguilles d’une montre, par rapport à l’orientation PORTRAIT.
ROT180 Rotation de 180 degrés dans le sens inverse des aiguilles d’une montre, par rapport à l’orientation PORTRAIT.
ROT270 Rotation de 270 degrés dans le sens inverse des aiguilles d’une montre, par rapport à l’orientation PORTRAIT.

 
WIA_IPS_PAGE_SIZE
ScannerPicturePageSize

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Contient la taille de la page actuellement définie pour être analysée. Une application définit cette propriété pour sélectionner les dimensions de la page à analyser. Le minidriver crée et gère cette propriété.

Type : VT_I4, Accès : Lecture/écriture, Valeurs valides : WIA_PROP_LIST

Pour connaître les constantes qui peuvent être utilisées avec cette propriété, consultez Constantes de taille de page WIA 2.0. Notez ces tailles non fixes, en particulier :

Valeur Définition
WIA_PAGE_CUSTOM Défini par les valeurs des propriétés WIA_IPS_PAGE_HEIGHT et WIA_IPS_PAGE_WIDTH .
WIA_PAGE_AUTO La taille de la page est automatiquement déterminée par l’appareil.
WIA_PAGE_CUSTOM_BASE Taille de page personnalisée dont les dimensions sont déjà connues de l’application et du pilote de périphérique.

 

La valeur de la propriété WIA_IPS_ORIENTATION détermine l’orientation de la page actuellement sélectionnée. Les propriétés WIA_IPS_PAGE_WIDTH et WIA_IPS_PAGE_HEIGHT indiquent les dimensions de la page, en millièmes de pouce. Ces propriétés doivent être conformes aux WIA_IPS_XEXTENT et WIA_IPS_YEXTENT, qui contiennent les dimensions de la page en pixels.

Remarque :
Les valeurs valides de type WIA_PROP_LIST dépendent des paramètres valides de la propriété WIA_IPS_ORIENTATION . Si, par exemple, l’appareil ne peut pas analyser des documents orientés paysage avec un paramètre WIA_PAGE_A4, WIA_PAGE_A4 n’est pas une valeur valide pour la propriété WIA_IPS_PAGE_SIZE lorsque WIA_IPS_ORIENTATION a la valeur PAYSAGE.

 

Si une application définit WIA_IPS_PAGE_SIZE sur une valeur autre que les trois du tableau ci-dessus, le minidriver doit ajuster les valeurs de WIA_IPS_PAGE_WIDTH et WIA_IPS_PAGE_HEIGHT aux dimensions de la page en millièmes de pouce. Il doit également ajuster les valeurs de WIA_IPS_XEXTENT et de WIA_IPS_YEXTENT aux dimensions de la page en pixels.

Si un paramètre d’extension (WIA_IPS_XEXTENT ou WIA_IPS_YEXTENT) est remplacé par une valeur qui ne correspond pas au paramètre de taille de page actuel, le minidriver doit modifier la valeur de la propriété WIA_IPS_PAGE_SIZE en WIA_PAGE_CUSTOM. Le minidriver doit également modifier WIA_IPS_PAGE_WIDTH ou WIA_IPS_PAGE_HEIGHT conformément au nouveau paramètre d’étendue.

Si WIA_IPS_ORIENTATION est défini sur LANDSCAPE, les paramètres d’extension sont échangés par rapport à leurs valeurs habituelles. Par exemple, si une application définit WIA_IPS_PAGE_SIZE sur WIA_PAGE_A4, le minidriver définit WIA_IPS_PAGE_WIDTH sur 11692 et WIA_IPS_PAGE_HEIGHT sur 8267. (Le minidriver doit également ajuster WIA_IPS_XEXTENT et WIA_IPS_YEXTENT en conséquence.)

Remarque :
Si WIA_IPS_PAGE_SIZE est défini sur WIA_PAGE_CUSTOM, le paramètre d’orientation n’est pas utilisé pour déterminer les dimensions d’étendue de la page à analyser.

 

Le minidriver est chargé de s’assurer que la propriété WIA_IPS_ORIENTATION est en accord avec la zone de sélection actuelle. Si une application remplace la valeur de WIA_IPS_ORIENTATION par une valeur non valide pour la taille de page actuellement sélectionnée, le minidriver doit remplacer la valeur de WIA_IPS_PAGE_SIZE par une taille de page prise en charge par la nouvelle valeur d’orientation.

Si une application définit la propriété WIA_IPS_PAGE_SIZE sur WIA_PAGE_CUSTOM, la zone de sélection actuelle n’est pas affectée. Le minidriver WIA doit obtenir la disposition actuelle de l’image, en commençant par les paramètres actuels des propriétés WIA_IPS_XPOS et WIA_IPS_YPOS . Si le paramètre de taille de page entraîne une zone de sélection située à l’extérieur du lit du scanneur, le minidriver doit ajuster automatiquement les valeurs des propriétés WIA_IPS_XPOS et WIA_IPS_YPOS aux paramètres valides. Si les propriétés WIA_IPS_PAGE_SIZE et WIA_IPS_ORIENTATION sont définies en même temps et qu’elles ne sont pas valides lorsqu’elles sont appliquées en combinaison, le minidriver doit échouer dans les paramètres de l’application en retournant une erreur dans IWiaMiniDrv::d rvValidateItemProperties.

Les quatre exemples suivants illustrent différents scénarios de WIA_IPS_PAGE_SIZE .

  1. Le pilote signale les paramètres.
  2. Une application définit la propriété WIA_IPS_PAGE_SIZE sur WIA_PAGE_LETTER.
  3. Une application définit la propriété WIA_IPS_ORIENTATION sur PAYSAGE.
  4. Une application remplace la propriété WIA_IPS_XEXTENT par une valeur plus petite.

Exemple 1 : le minidriver signale les paramètres

Dans l’exemple suivant, le minidriver définit une zone de sélection personnalisée avant qu’une application ne définisse les propriétés WIA. Dans ce cas, la zone de sélection représente l’intégralité du lit plat.

WIA_IPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_IPS_PAGE_WIDTH = 11500
WIA_IPS_PAGE_HEIGHT = 14000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1150
WIA_IPS_YEXTENT = 1400
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Exemple 2 : une application définit la propriété WIA_IPS_PAGE_SIZEsur WIA_PAGE_LETTER

WIA_IPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_IPS_PAGE_WIDTH = 8500
WIA_IPS_PAGE_HEIGHT = 11000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 850
WIA_IPS_YEXTENT = 1100
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Exemple 3 : Une application définit lapropriété WIA_IPS_ORIENTATIONsur LANDSCAPE

Le lit physique doit être en mesure d’acquérir une page qui était à l’origine en orientation paysage.

WIA_IPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_IPS_PAGE_HEIGHT = 11000
WIA_IPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANDSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1100
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Exemple 4 : Une application modifie la propriété WIA_IPS_XEXTENTen une valeur plus petite

Dans l’exemple suivant, une application modifie la propriété WIA_IPS_XEXTENT sur 1000. Le minidriver doit supposer que la nouvelle valeur contenue dans WIA_IPS_XEXTENT n’est plus valide pour la propriété WIA_IPS_PAGE_SIZE et doit donc remplacer WIA_IPS_PAGE_SIZE par WIA_PAGE_CUSTOM. Le minidriver doit également ajuster WIA_IPS_PAGE_WIDTH.

WIA_IPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_IPS_PAGE_HEIGHT = 10000
WIA_IPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANDSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1000
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100
WIA_IPS_PAGE_HEIGHT
ScannerPicturePageHeight

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Contient la hauteur, en millièmes de pouce, de la page actuellement sélectionnée. Le minidriver crée et gère la propriété WIA_IPS_PAGE_HEIGHT . Une application lit cette propriété pour déterminer les dimensions physiques de la page analysée. Si les paramètres d’étendue sont différents des tailles de page connues, cette propriété indique la hauteur de la page dont la propriété WIA_IPS_PAGE_SIZE est définie sur WIA_PAGE_CUSTOM (qui est une valeur de la propriété WIA_IPS_PAGE_SIZE ). WIA_IPS_PAGE_HEIGHT doit être synchronisé avec WIA_IPS_XEXTENT, qui indique la hauteur, en pixels, de la page à analyser.

Cette propriété est requise pour les éléments WIA_CATEGORY_FEEDER.

Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE
WIA_IPS_PAGE_WIDTH
ScannerPicturePageWidth

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Contient la largeur de la page active sélectionnée, en millièmes de pouce. Une application lit cette propriété pour déterminer les dimensions physiques de la page analysée. Si les paramètres d’étendue sont différents des tailles de page connues, cette propriété indique la largeur de la page dont la propriété WIA_IPS_PAGE_SIZE est définie sur WIA_PAGE_CUSTOM. WIA_IPS_PAGE_WIDTH doit être synchronisé avec la valeur de WIA_IPS_XEXTENT, qui indique la largeur, en pixels, de la page à analyser. Le minidriver crée et gère cette propriété.

Cette propriété est requise pour les éléments WIA_CATEGORY_FEEDER.

Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE
WIA_IPS_PAGES
ScannerPicturePages

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Contient le nombre actuel de pages à acquérir à partir d’un chargeur de documents automatique. Le minidriver crée et gère cette propriété.

Type : VT_I4 ; Accès : lecture/écriture ; Valeurs valides : WIA_PROP_RANGE Le nombre maximal de pages que le scanneur peut analyser est égal à zéro. La valeur est ALL_PAGES (= 0) si le scanneur peut analyser en continu.

Une application lit cette propriété pour déterminer la capacité de page du chargeur de documents. L’application définit également cette propriété sur le nombre de pages qu’elle va analyser.

Remarque :
Si le mode duplex est activé (WIA_IPS_DOCUMENT_HANDLING_SELECT est défini sur FEEDER | DUPLEX | ADVANCED_DUPLEX), WIA_IPS_PAGES est toujours égal au nombre de pages à analyser.

 

Une feuille de papier contient automatiquement deux pages si DUPLEX est activé, même si la face arrière de la page est vide.

La définition de WIA_IPS_PAGES sur 1 entraîne le traitement d’un côté de la page par un scanneur. Si un scanneur ne peut analyser qu’un seul côté d’une page en mode duplex, nous vous recommandons de modifier la valeur WIA_IPS_PAGES pour le membre Inc du membre Range de la structure WIA_PROPERTY_INFO sur 2. Cette valeur indique à l’application qu’elle doit demander des pages en plusieurs de deux. La valeur ALL_PAGES (= 0) signifie que toutes les pages actuellement chargées dans le chargeur de documents doivent être analysées.
WIA_IPS_PHOTOMETRIC_INTERP
ScannerPicturePhotometricInterp

Contient le paramètre actuel pour les pixels blancs et noirs. Le minidriver crée et gère cette propriété.

Une application lit cette valeur pour déterminer la valeur WHITE ou BLACK (en fonction de ce que fait l’application).

Obligatoire pour tous les éléments stockés ou activés pour l’acquisition ; c’est-à-dire les éléments des catégories : WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK, WIA_CATEGORY_FINISHED_FILE et WIA_CATEGORY_FILM. Il n’est pas pris en charge pour les éléments WIA_CATEGORY_FOLDER.

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 WIA_PROP_LIST type et placez-y la valeur valide.

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

Valeur Définition
WIA_PHOTO_WHITE_0 BLANC est 0, et NOIR est 1.
WIA_PHOTO_WHITE_1 LE BLANC est 1 et LE NOIR est 0.

 
WIA_IPS_PREVIEW
ScannerPicturePreview

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Indique le mode d’aperçu d’un appareil. Une application définit cette propriété pour placer l’appareil en mode d’aperçu.

Cette propriété est requise pour les éléments WIA_CATEGORY_FLATBED et WIA_CATEGORY_FILM, facultatif pour l’élément WIA_CATEGORY_FEEDER.

Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST

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

Valeur Définition
WIA_FINAL_SCAN L’application effectue une analyse finale.
WIA_PREVIEW_SCAN L’application effectue une analyse en préversion.

 
WIA_IPS_PREVIEW_TYPE
ScannerPicturePreviewType

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Spécifie si l’image d’aperçu existante peut être mise à jour pendant une préversion d’image (en réponse à une modification des propriétés WIA_IPA_DATATYPE ou WIA_IPA_DEPTH).

Cette propriété est facultative pour tous les éléments activés pour l’acquisition qui prennent en charge les analyses en préversion ; autrement dit, WIA_IPS_PREVIEW est pris en charge avec WIA_PREVIEW_SCAN. Cela inclut les éléments de types WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK et WIA_CATEGORY_FILM.

Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE

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

Constant Description
WIA_ADVANCED_PREVIEW La mise à jour de l’image existante est possible.
WIA_BASIC_PREVIEW Une autre analyse d’aperçu doit être exécutée, car la mise à jour de l’image existante n’est pas possible.

 
WIA_IPS_ROTATION
ScannerPictureRotation

Contient le paramètre de rotation actuel, s’il est implémenté. Le minidriver crée et gère cette propriété.

Une application définit cette propriété pour indiquer au pilote la quantité (le cas échéant) de rotation de l’image avant que le pilote ne la retourne à l’application.

Remarque :
WIA_IPS_ORIENTATION fait référence à la position du document à analyser sur le lit ou le chargeur du scanneur. Il s’agit de l’orientation du document par rapport au sens de l’analyse. WIA_IPS_ROTATION fait référence à la rotation appliquée à l’image après son analyse, juste avant le transfert de l’image vers l’application.

 

Le minidriver WIA est chargé de faire pivoter les données d’image avant de les renvoyer à l’application. L’application est responsable de la vérification des en-têtes d’image pour voir les valeurs nouvellement pivotées.

Il existe une grande confusion quant à la résolution de l’effet de la rotation sur la zone de sélection de l’image actuelle (qui est définie par les propriétés WIA_IPS_XPOS, WIA_IPS_YPOS, WIA_IPS_XEXTENT et WIA_IPS_YEXTENT ).

La zone de sélection fait référence à la zone sélectionnée sur le lit du scanneur physique à partir duquel une image est acquise. WIA_IPS_ROTATION ne modifie pas la zone de sélection. Le pilote applique une rotation dans le sens inverse des aiguilles d’une montre en fonction de WIA_IPS_ROTATION seulement une fois que le pilote a acquis la zone de sélection appropriée. WIA_IPS_ROTATION affecte les dimensions de l’image de sortie. Ces dimensions doivent donc être reflétées dans l’en-tête de données de l’image obtenue.

Facultatif pour tous les éléments activés par l’acquisition ; c’est-à-dire les éléments des catégories : WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK et WIA_CATEGORY_FILM.

Type : VT_I4, Accès : Lecture/écriture, Valeurs valides : WIA_PROP_LIST

Les constantes de rotation suivantes sont définies.

Constant Définition
PORTRAIT Le pilote ne fait pas pivoter l’image.
PAYSAGE TLe pilote fait pivoter l’image de 90 degrés dans le sens inverse des aiguilles d’une montre.
ROT180 Le pilote fait pivoter l’image de 180 degrés dans le sens inverse des aiguilles d’une montre.
ROT270 Le pilote fait pivoter l’image de 270 degrés dans le sens inverse des aiguilles d’une montre.

 
WIA_IPS_SEGMENTATION
ScannerPictureSegmentation

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Spécifie si l’application doit utiliser le filtre de segmentation du pilote pour l’analyse multirégion. WIA_IPS_SEGMENTATION doivent être implémentés pour les éléments WIA_CATEGORY_FLATBED et WIA_CATEGORY_FILM s’ils prennent en charge la création d’éléments enfants avec un filtre de segmentation ou si le pilote lui-même crée des éléments enfants pour les images fixes.

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é.

Valeur Définition
WIA_USE_SEGMENTATION_FILTER L’application doit utiliser le filtre de segmentation pour l’analyse multirégion.
WIA_DONT_USE_SEGMENTATION_FILTER Le pilote crée les éléments enfants lui-même pour l’analyse multirégion. C’est généralement le cas si le scanneur utilise des images fixes à cet effet.

 

Remarque :
Il est possible qu’un pilote soit équipé d’un filtre de segmentation, mais WIA_IPS_SEGMENTATION toujours défini sur WIA_DONT_USE_SEGMENTATION_FILTER pour l’un de ses éléments (par exemple, l’élément WIA_CATEGORY_FILM). Cela peut être le cas si le scanneur utilise des images fixes pour l’analyse de film, mais pas pour l’analyse régulière à partir d’éléments WIA_CATEGORY_FLATBED.

 
WIA_IPS_SHEET_FEEDER_REGISTRATION
ScannerPictureSheetFeederRegistration

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Contient l’inscription, ou la détection d’alignement et de bord, pour les documents placés sur le plat. Le minidriver crée et gère cette propriété. Cette propriété indique comment la feuille est positionnée horizontalement sur la tête d’analyse d’un scanneur portable ou alimenté par une feuille. La propriété est utilisée pour prédire l’emplacement d’un document dans la tête d’analyse.

Pour les scanneurs qui prennent en charge plusieurs têtes d’analyse, cette propriété est relative à la tête d’analyse la plus haute. Cette propriété est obligatoire pour les scanneurs à feuilles, scroll-fed et portables.

Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE

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

Constant Description
LEFT_JUSTIFIED La feuille est positionnée à gauche par rapport à la tête de balayage.
CENTRÉ La feuille est centrée sur la tête d’analyse.
RIGHT_JUSTIFIED La feuille est positionnée à droite par rapport à la tête de balayage.

 
WIA_IPS_SHOW_PREVIEW_CONTROL
ScannerPictureShowPreviewControl

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Indique si un élément a besoin d’un contrôle d’aperçu affiché à l’utilisateur. Le minidriver crée et gère cette propriété.

Facultatif pour tous les éléments activés pour le transfert. Il s’agit généralement uniquement d’éléments des catégories WIA_ITEM_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FILM et WIA_CATEGORY_FINISHED_FILE.

Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE

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

Constant Description
WIA_SHOW_PREVIEW_CONTROL Affichez un contrôle d’aperçu à l’utilisateur, car cet appareil peut effectuer une préversion.
WIA_DONT_SHOW_PREVIEW_CONTROL N’affichez pas de contrôle d’aperçu à l’utilisateur, car cet appareil ne peut pas effectuer une préversion.

 
WIA_IPS_SUPPORTS_CHILD_ITEM_CREATION
ScannerPictureSupportsChildItemCreation

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Spécifie si l’application (ou les filtres) peut créer des éléments enfants sous l’élément actif.

Facultatif pour toutes les catégories d’éléments activées pour le transfert : WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FILM et même WIA_CATEGORY_FOLDER. (Si le stockage ne prend pas en charge le chargement de nouveaux éléments, cette propriété doit être non prise en charge ou prise en charge avec la valeur FALSE .)

Les éléments prenant en charge les WIA_IPS_SEGMENTATION et les WIA_USE_SEGMENTATION_FILTER doivent également prendre en charge WIA_IPS_SUPPORTS_CHILD_ITEM_CREATION et avoir la valeur TRUE.

Type : VT_I4, Accès : Lecture seule, Valeurs valides : TRUE et FALSE
WIA_IPS_THRESHOLD
ScannerPictureThreshold

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Spécifie la valeur de nuances de gris qui détermine si un pixel sera converti en blanc ou noir lorsqu’une image est convertie en monochromatique. Les pixels au-dessus du seuil deviennent blancs. Les pixels inférieurs au seuil deviennent blancs.

Cette propriété est requise pour les éléments d’acquisition qui prennent en charge les analyses 1-bpp et dont la propriété WIA_IPA_DATATYPE est définie sur WIA_DATA_THRESHOLD.

Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_RANGE
WIA_IPS_TRANSFER_CAPABILITIES
ScannerPictureTransferCapabilities

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Spécifie si le pilote est capable de transférer plusieurs éléments enfants dans un seul appel de transfert.

Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_FLAG

La seule valeur possible pour cette propriété est WIA_TRANSFER_CHILDREN_SINGLE_SCAN. Si cet indicateur est défini, le pilote est capable de transférer plusieurs éléments enfants en un seul appel de transfert. Si l’indicateur n’est pas défini, le service WIA parcourra les éléments enfants de manière récursive, puis transférera chacun de ces éléments.
WIA_IPA_UPLOAD_ITEM_SIZE
ScannerPictureInvert

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Spécifie le nombre d’octets à charger pour l’élément.

Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_NONE
WIA_IPS_WARM_UP_TIME
ScannerPictureWarmUpTime

Spécifie le temps de préchauffage maximal, en millisecondes, dont l’appareil a besoin avant de démarrer l’opération d’analyse. Le minidriver crée et gère cette propriété.

Une application peut lire cette propriété pour déterminer le temps de préchauffement maximal de cet appareil. Il peut ensuite présenter une boîte de dialogue « attendre que l’appareil se préchauffe » pour informer l’utilisateur qu’une attente ou une pause peut se produire avant que quoi que ce soit se produise.

Cette propriété est requise pour tous les éléments activés pour l’acquisition ; c’est-à-dire les éléments des catégories : WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK et WIA_CATEGORY_FILM.

Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE
WIA_IPS_XEXTENT
ScannerPictureXextent

Contient la largeur actuelle, en pixels, de l’image sélectionnée à acquérir. Une application définit cette propriété pour marquer la largeur d’une zone de sélection à acquérir. Cette propriété doit être d’accord avec la propriété WIA_IPA_PIXELS_PER_LINE . Le minidriver crée et gère cette propriété.

Obligatoire pour tous les éléments activés pour l’acquisition ; c’est-à-dire les éléments des catégories : WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK et WIA_CATEGORY_FILM.

Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_RANGE
WIA_IPS_XPOS
ScannerPictureXpos

Contient la coordonnée x, en pixels, du coin supérieur gauche de l’image sélectionnée. Une application définit cette propriété pour marquer le coin supérieur gauche de la zone de sélection. Le minidriver crée et gère cette propriété.

Obligatoire pour tous les éléments activés pour l’acquisition ; c’est-à-dire les éléments des catégories : WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK, WIA_CATEGORY_FINISHED_FILE et WIA_CATEGORY_FILM. Il n’est pas pris en charge pour les éléments WIA_CATEGORY_FOLDER.

Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_RANGE
WIA_IPS_XRES
ScannerPictureXres

Contient la résolution horizontale actuelle, en pixels par pouce, pour l’appareil. Une application définit cette propriété pour définir la résolution horizontale. 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. Il s’agit également d’un cas où un paramètre de résolution dépend d’une autre résolution. (La résolution verticale peut dépendre de la résolution horizontale.)

Obligatoire pour tous les éléments activés pour l’acquisition ; c’est-à-dire les éléments des catégories : WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK, WIA_CATEGORY_FINISHED_FILE et WIA_CATEGORY_FILM. Il n’est pas pris en charge pour les éléments WIA_CATEGORY_FOLDER.

Type : VT_I4, Accès : lecture/écriture ou lecture seule, Valeurs valides : WIA_PROP_RANGE ou WIA_PROP_LIST
WIA_IPS_XSCALING
ScannerPictureXscaling

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Définit la mise à l’échelle horizontale, sous forme de pourcentage, qui peut être appliquée aux images analysées au sein du périphérique scanneur ou de son pilote.

Cette propriété est facultative pour tous les éléments activés pour l’acquisition ; c’est-à-dire des éléments de types WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK et WIA_CATEGORY_FILM.

Type : VT_I4, Access : lecture/écriture ou lecture seule, Valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE.

Les valeurs peuvent être comprises entre 1 et VT_I4 maximum (0xFFFF). Par exemple, 100 signifie aucune mise à l’échelle, 050 signifie un scale-down à 50 % de la taille orignale et 200 signifie une mise à l’échelle jusqu’à 200 % de la taille d’origine.
WIA_IPS_YEXTENT
ScannerPictureYextent

Contient la hauteur actuelle, en pixels, de l’image sélectionnée à acquérir. Une application définit cette propriété pour marquer la hauteur d’une zone de sélection. Cette propriété doit être en accord avec la valeur de la propriété WIA_IPA_PIXELS_PER_LINE . Le minidriver crée et gère cette propriété.

Obligatoire pour tous les éléments activés pour l’acquisition ; c’est-à-dire les éléments des catégories : WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK et WIA_CATEGORY_FILM.

Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_RANGE
WIA_IPS_YPOS
ScannerPictureYpos

Coordonnée y actuelle, en pixels, du coin supérieur gauche de l’image sélectionnée. Une application définit cette propriété pour marquer le coin supérieur gauche de la zone de sélection. Le minidriver crée et gère cette propriété.

Obligatoire pour tous les éléments activés pour l’acquisition ; c’est-à-dire les éléments des catégories : WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK, WIA_CATEGORY_FINISHED_FILE et WIA_CATEGORY_FILM. Il n’est pas pris en charge pour les éléments WIA_CATEGORY_FOLDER.

Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_RANGE
WIA_IPS_YRES
ScannerPictureYres

Contient la résolution verticale actuelle, en pixels par pouce, pour l’appareil. Une application définit cette propriété pour définir la résolution verticale. 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. Il s’agit également d’un cas où un paramètre de résolution dépend d’une autre résolution. (La résolution horizontale peut dépendre de la résolution verticale.)

Obligatoire pour tous les éléments activés pour l’acquisition ; c’est-à-dire les éléments des catégories : WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK, WIA_CATEGORY_FINISHED_FILE et WIA_CATEGORY_FILM. Il n’est pas pris en charge pour les éléments WIA_CATEGORY_FOLDER.

Type : VT_I4, Accès : lecture/écriture ou lecture seule, Valeurs valides : WIA_PROP_RANGE ou WIA_PROP_LIST
WIA_IPS_YSCALING
ScannerPictureYscaling

Remarque :
Cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

 

Définit la mise à l’échelle verticale, sous forme de pourcentage, qui peut être appliquée aux images analysées au sein du périphérique scanneur ou de son pilote.

Cette propriété est facultative pour tous les éléments activés pour l’acquisition ; c’est-à-dire des éléments de types WIA_CATEGORY_FLATBED, WIA_CATEGORY_FEEDER, WIA_CATEGORY_FEEDER_FRONT, WIA_CATEGORY_FEEDER_BACK et WIA_CATEGORY_FILM.

Type : VT_I4, Access : lecture/écriture ou lecture seule, Valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE.

Les valeurs peuvent être comprises entre 1 et VT_I4 maximum (0xFFFF). Par exemple, 100 signifie aucune mise à l’échelle, 050 signifie un scale-down à 50 % de la taille orignale et 200 signifie une mise à l’échelle jusqu’à 200 % de la taille d’origine.

Spécifications

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