Constantes de propriété de périphérique de scanneur

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 scanneurs d’images numériques.

Le préfixe « WIA _ DPS _ » indique une propriété d’appareil pour les périphériques de scanneur et est la Convention d’affectation de noms utilisée dans C/C++. À des fins de script, ces constantes utilisent le préfixe « ScannerDevice » 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.

Constante/valeur Description
WIA_DPS_DEVICE_ID
ScannerDeviceDeviceId
[!Note]
cette propriété est prise en charge uniquement sur Windows Vista et versions ultérieures.

Contient un identificateur d’instance de fonction unique pour un périphérique de scanneur de services Web. Cet identificateur représente le service Web sur le périphérique de scanneur avec lequel le mini-pilote WIA communique. Aucune hypothèse relative à la forme de cet identificateur ne doit être faite. Le mini-pilote WIA crée et gère cette propriété.
Les applications WIA peuvent utiliser la valeur de WIA_DPS_DEVICE_ID pour trouver, à l’aide de l’API de détection de fonction, l’objet d’instance de fonction représentant le périphérique Web services scanner utilisé dans la session WIA 2,0 actuelle.
Type : VT_BSTR, Access : lecture seule, valeurs valides : WIA_PROP_NONE
WIA_DPS_DITHER_PATTERN_DATA
Réservé, n’utilisez pas.
Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE
WIA_DPS_DITHER_SELECT
Réservé, n’utilisez pas.
Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE
WIA_DPS_DOCUMENT_HANDLING_CAPABILITIES
ScannerDeviceDocumentHandlingCapabilities
Contient les fonctionnalités du scanneur. Le minipilote crée et gère cette propriété.
Une application lit cette propriété pour déterminer si le scanneur a un plateau, un chargeur de documents ou un duplexeur installé. Cette propriété est également utilisée pour définir plus précisément les fonctionnalités installées.
Type : VT_I4, Access : lecture seule, valeurs valides : WIA_PROP_NONE
le tableau suivant décrit les constantes qui sont valides avec Windows 7 uniquement.
Indicateurs Description
AUTO_SOURCE Un gestionnaire de documents automatique est installé sur le scanneur.

le tableau suivant décrit les constantes qui sont valides avec Windows 7 et Windows Vista uniquement.

Indicateurs Description
ADVANCED_DUP L’appareil prend en charge la configuration avancée de l’analyse duplex. Utilisez WIA_IPS_DUPLEX_SETTINGS pour basculer entre l’utilisation de configurations duplex de base et avancées.
DETECT_FILM_TPA Le scanneur peut détecter lorsque la carte de transparence/film est prête à être analysée.
DETECT_STOR Le scanneur peut détecter les documents dans le stockage interne.
FILM_TPA Le scanneur est équipé d’un adaptateur d’analyse de transparence/film.
STOR Le scanneur est équipé d’un dispositif de stockage d’images interne.

le tableau suivant décrit les constantes qui sont valides avec Windows XP ou version ultérieure.

Indicateurs Description
DETECT_FEED Le scanneur peut détecter un document dans le chargeur.
DETECT_FLAT Le scanneur peut détecter un document sur le plateau à plat.
DETECT_SCAN Le scanneur peut détecter un document dans le chargeur uniquement en analysant.
DUP Le scanneur a un duplex.
ALIMENTAIRE Un gestionnaire de documents automatique est installé sur le scanneur.
PLATE Le scanneur a un plateau à plateau.

le tableau suivant décrit les constantes qui sont valides avec Windows XP uniquement. ces valeurs ont été dépréciées pour Windows 7 et Windows Vista et ne doivent pas être utilisées.

Indicateurs Description
DETECT_DUP Le scanneur peut détecter une demande d’analyse duplex de la part de l’utilisateur.
DETECT_DUP_AVAIL Le scanneur peut déterminer à quel moment le duplexeur est installé.
DETECT_FEED_AVAIL Le scanneur peut déterminer quand le chargeur automatique de documents est installé.

WIA_DPS_DOCUMENT_HANDLING_SELECT
ScannerDeviceDocumentHandlingSelect
[!Note]
cette propriété n’est pas prise en charge dans Windows Vista et versions ultérieures. Utilisez WIA_IPS_DOCUMENT_HANDLING_SELECT.

Contient la source et le mode d’acquisition du scanneur en cours. Le minipilote 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é afin de 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 duplex.

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

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

Indicateurs Description
FEEDER Analyse à l’aide du chargeur de documents.
Scanner Numérisez à l’aide du plateau.
DUPLEX Analyse à l’aide d’opérations duplex.
AUTO_ADVANCE Active l’alimentation automatique du document suivant après une analyse.
FRONT_FIRST Commencez par analyser le recto du document. Cette valeur est valide lorsque DUPLEX est défini.
BACK_FIRST Commencez par analyser le verso du document. Cette valeur est valide lorsque DUPLEX est défini.
FRONT_ONLY Analysez l’avant uniquement. Cette valeur est valide lorsque DUPLEX est défini.
BACK_ONLY Analyser l’arrière uniquement. Cette valeur est valide lorsque DUPLEX est défini.
NEXT_PAGE Analyse la page suivante du document.
Préalimentation Activez le mode de pré-flux. Prépositionner le document suivant lors de l’analyse.

WIA_DPS_DOCUMENT_HANDLING_STATUS
ScannerDeviceDocumentHandlingStatus

Contient l’état actuel du plateau installé du scanneur, du chargeur de documents ou du duplexeur. Le minipilote crée et gère cette propriété.

Une application lit cette propriété pour déterminer si le périphérique du scanneur est prêt à être utilisé. Il s’agit d’une façon idéale de vérifier si le papier est dans le chargeur avant d’acquérir une image.

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

Le tableau suivant contient les constantes qui sont 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. le symbole V indique que l’indicateur est pris en charge uniquement dans Windows Vista et versions ultérieures.

Indicateurs Description
FEED_READY Le plateau est prêt à l’emploi.
FLAT_READY Le scanneur a un document sur le plateau à plat.
DUP_READY Le duplexeur est activé et prêt à être utilisé.
FLAT_COVER_UP Le cache plat est en place.
PATH_COVER_UP Le chemin d’accès au papier est couvert et empêche le bon fonctionnement.
PAPER_JAM Un document est coincé dans le chargeur de documents.
FILM_TPA_READYV L’adaptateur de transparence est installé et prêt à l’emploi.
STORAGE_READYV Le dispositif de stockage interne est prêt.
STORAGE_FULLV Le stockage est plein, aucune opération de chargement n’est possible.
MULTIPLE_FEEDV Une condition de flux multiples s’est produite (généralement avec un PAPER_JAM).
DEVICE_ATTENTIONV Une erreur nécessite une intervention de l’utilisateur sur l’appareil.
LAMP_ERRV Le scanneur n’est pas prêt en raison d’un problème de lampe.

WIA_DPS_ENDORSER_CHARACTERS
ScannerDeviceEndorserCharacters

Contient tous les caractères valides qu’une application peut utiliser pour créer des chaînes d’endosseur valides. Un endosseur est une imprimante installée sur un scanneur qui imprime un message texte sur chaque page analysée. Le minipilote doit valider la valeur de la propriété WIA_DPS_ENDORSER_STRING par rapport au jeu de caractères valide dans cette propriété. Le minipilote crée et gère cette propriété.

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

WIA_DPS_ENDORSER_STRING
ScannerDeviceEndorserString

Contient une chaîne qui doit être approuvée (en d’autres termes, imprimée) sur chaque page analysée par le minipilote. Une application définit cette propriété à l’aide du jeu de caractères valide signalé dans la propriété WIA_DPS_ENDORSER_CHARACTERS . Le minipilote doit approuver les documents uniquement si une chaîne est définie dans cette propriété. Une chaîne vide signifie que la fonctionnalité de l’endosseur est désactivée.

Étant donné que le pilote est responsable de l’interprétation de la chaîne d’endossement, votre pilote peut utiliser des caractères spéciaux dans WIA_DPS_ENDORSER_STRING. Toutefois, seules vos applications comprendront ces caractères.

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

Un pilote qui prend en charge la propriété WIA_DPS_ENDORSER_STRING doit prendre en charge la liste de jetons suivante.

par jeton Description
$DATE $ Date au format AAAA/MM/JJ.
$DAY $ Jour au format jj.
$MONTH $ Mois de l’année au format MM.
$PAGE _COUNT $ Nombre de pages transférées.
$TIME $ Heure de la journée au format HH : MM : SS.
$YEAR $ Année au format YYYY.

WIA_DPS_FILTER_SELECT

Réservé, n’utilisez pas.

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

WIA_DPS_GLOBAL_IDENTITY
ScannerDeviceGlobalIdentity
[!Note]
cette propriété est prise en charge uniquement sur Windows Vista et versions ultérieures.

Contient l’adresse SOAP d’un périphérique de scanneur de services Web. Le mini-pilote WIA 2,0 crée et gère cette propriété.

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

WIA_DPS_HORIZONTAL_BED_REGISTRATION
ScannerDeviceHorizontalBedRegistration
[!Note]
cette propriété n’est pas prise en charge avec Windows Vista et versions ultérieures.

Contient l’enregistrement ou l’alignement horizontal pour les documents placés sur le plateau. Le minipilote crée et gère cette propriété.

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

Constante Description
LEFT_JUSTIFIED Le papier est justifié à gauche.
PARTANT Le papier est centré.
RIGHT_JUSTIFIED Le papier est justifié à droite.

Voir aussi

WIA_DPS_VERTICAL_BED_REGISTRATION

WIA_DPS_HORIZONTAL_BED_SIZE
ScannerDeviceHorizontalBedSize
[!Note]
cette propriété n’est pas prise en charge avec Windows Vista et versions ultérieures. Utilisez WIA_IPS_MAX_HORIZONTAL_SIZE.

Spécifie la largeur maximale, en millièmes de pouce, qui est numérisée sur l’axe horizontal (X) à partir du plateau d’un scanneur à plat dans la résolution actuelle. Cette propriété s’applique également aux alimentations automatiques de documents qui déplacent des feuilles vers le plateau d’un scanneur à plat pour l’analyse. Cette propriété est obligatoire pour les scanneurs qui ont un plateau. À la place, les autres types de scanneurs implémentent la propriété WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE .

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

WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceHorizontalSheetFeedSize
[!Note]
cette propriété n’est pas prise en charge avec Windows Vista et versions ultérieures. Utilisez WIA_IPS_MAX_HORIZONTAL_SIZE.

Spécifie la largeur maximale, en millièmes de pouce, qui est numérisée sur l’axe horizontal (X) à partir d’un scanneur de papier portable ou de feuille à la résolution actuelle. Cette propriété s’applique également aux alimentations automatiques de documents qui analysent sans déplacer les feuilles vers le plateau d’un scanneur à plat. Cette propriété est obligatoire pour les scanneurs de feuilles, le défilement et les scanneurs.

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

WIA_DPS_MAX_SCAN_TIME
ScannerDeviceMaxScanTime

Contient la durée maximale d’analyse d’une page unique avec les paramètres de propriété actuels, en millisecondes. Une application lit cette propriété pour estimer le temps nécessaire à l’analyse d’une page. Cela est utile lorsque vous déterminez les conditions d’un appareil qui a cessé de répondre. Le minipilote crée et gère cette propriété. Cette propriété est obligatoire pour tous les scanneurs.

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

WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceMinHorizontalSheetFeedSize
[!Note]
cette propriété n’est pas prise en charge avec Windows Vista et versions ultérieures. Utilisez WIA_IPS_MIN_HORIZONTAL_SIZE.

Contient les dimensions horizontales physiques de la plus petite page que le chargeur de documents du scanneur peut analyser, en millièmes de pouce. Le minipilote crée et gère cette propriété.

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

Voir aussi

WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE

WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceMinVerticalSheetFeedSize
[!Note]
cette propriété n’est pas prise en charge avec Windows Vista et versions ultérieures. Utilisez WIA_IPS_MIN_VERTICAL_SIZE.

Contient les dimensions verticales physiques de la plus petite page que le chargeur de documents du scanneur peut analyser, en millièmes de pouce. Le minipilote crée et gère cette propriété.

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

Voir aussi

WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE

WIA_DPS_OPTICAL_XRES
ScannerDeviceOpticalXres
[!Note]
cette propriété n’est pas prise en charge par Windows Vista. Utilisez WIA_IPS_OPTICAL_XRES.

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 qui peuvent être générées par l’appareil. Au lieu de cela, il s’agit de la résolution des optiques de l’appareil. Le minipilote crée et gère cette propriété. Cette propriété est obligatoire pour tous les scanneurs.

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

WIA_DPS_OPTICAL_YRES
ScannerDeviceOpticalYres
[!Note]
cette propriété n’est pas prise en charge par Windows Vista. Utilisez WIA_IPS_OPTICAL_YRES.

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. Au lieu de cela, il s’agit de la résolution des optiques de l’appareil. Le minipilote crée et gère cette propriété. Cette propriété est obligatoire pour tous les scanneurs.

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

WIA_DPS_ORIENTATION
ScannerDeviceOrientation

Contient le paramètre d’orientation actuel. Le minipilote crée et gère cette propriété.

Une application définit la propriété WIA_DPS_ORIENTATION 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_DPS_ORIENTATION, consultez WIA_DPS_PAGE_SIZE

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

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

Valeur Définitment
JARDIN rotation de 90 degrés-sens des aiguilles d’une montre, par rapport à l’orientation PORTRAIT.
Aperçu 0 degré.
ROT180 rotation de 180 degrés-sens des aiguilles d’une montre, par rapport à l’orientation PORTRAIT.
ROT270 rotation de 270 degrés-sens des aiguilles d’une montre, par rapport à l’orientation PORTRAIT.

Voir aussi

WIA_IPS_ROTATION

WIA_DPS_PAD_COLOR
ScannerDevicePadColor

Couleur utilisée pour remplir le bloc lorsqu’il n’y a pas assez de données image pour remplir une mémoire tampon demandée. Cette propriété est implémentée pour les scanneurs qui complètent la mémoire tampon. Cette propriété est facultative pour tous les scanneurs. Le minipilote crée et gère cette propriété.

Type : VT_UI1 | VT_VECTOR, Access : lecture seule, valeurs valides : WIA_PROP_NONE

Le format des informations de couleur est RGBQUAD.

WIA_DPS_PAGE_HEIGHT
ScannerDevicePageHeight
[!Note]
cette propriété n’est pas prise en charge par Windows Vista. Utilisez WIA_IPS_PAGE_HEIGHT.

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

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

WIA_DPS_PAGE_SIZE
ScannerDevicePageSize
[!Note]
cette propriété n’est pas prise en charge par Windows Vista. Utilisez WIA_IPS_PAGE_SIZE.

Contient la taille de la page actuellement sélectionnée pour être analysée. Pour sélectionner les dimensions de la page à analyser, une application définit cette propriété. Le minipilote crée et gère cette propriété.

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 Définition
WIA_PAGE_A4 8267 X 11692 (orientation PORTRAIT)
WIA_PAGE_CUSTOM Défini par les valeurs des propriétés WIA_DPS_PAGE_HEIGHT et WIA_DPS_PAGE_WIDTH
WIA_PAGE_LETTER 8500 X 11000 (orientation PORTRAIT)

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_DPS_PAGE_WIDTH et WIA_DPS_PAGE_HEIGHT signalent les dimensions de la page, en millièmes de pouce. Notez que ces propriétés doivent être accordées avec WIA_IPS_XEXTENT et WIA_IPS_YEXTENT, qui contiennent les dimensions de la page en pixels. Les valeurs valides de type WIA_PROP_LIST doivent dépendre des paramètres valides de la propriété WIA_IPS_ORIENTATION . Si l’appareil ne peut pas analyser les documents orientés paysage avec un paramètre WIA_PAGE_A4, WIA_PAGE_A4 ne doit pas apparaître dans la liste des valeurs valides pour la propriété WIA_DPS_PAGE_SIZE lorsque WIA_IPS_ORIENTATION a la valeur Lanscape.

Si une application définit WIA_DPS_PAGE_SIZE sur une valeur autre que WIA_PAGE_CUSTOM, le minipilote doit ajuster les valeurs de WIA_DPS_PAGE_WIDTH et WIA_DPS_PAGE_HEIGHT aux dimensions de la page, en millièmes de pouce. Elle doit également ajuster les valeurs de WIA_IPS_XEXTENT et WIA_IPS_YEXTENT sur les dimensions de la page en pixels.

Si un paramètre d’extension (WIA_IPS_XEXTENT ou WIA_IPS_YEXTENT) est changé en une valeur qui ne correspond pas au paramètre de taille de page actuel, le minipilote doit changer la valeur de la propriété WIA_DPS_PAGE_SIZE en WIA_PAGE_CUSTOM. Le minipilote doit également modifier WIA_DPS_PAGE_WIDTH ou WIA_DPS_PAGE_HEIGHT conformément au nouveau paramètre d’extension.

Si WIA_IPS_ORIENTATION a la valeur Lanscape, les paramètres d’étendue sont " retournés. " Par exemple, si une application définit WIA_DPS_PAGE_SIZE sur WIA_PAGE_A4, le minipilote doit définir WIA_DPS_PAGE_WIDTH sur 11692 et WIA_DPS_PAGE_HEIGHT sur 8267. (Le minipilote doit également définir WIA_IPS_XEXTENT et WIA_IPS_YEXTENT en conséquence). Notez que si WIA_DPS_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 minipilote 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 minipilote doit changer la valeur de WIA_DPS_PAGE_SIZE en une taille de page prise en charge par la nouvelle valeur d’orientation.

Si une application définit la propriété WIA_DPS_PAGE_SIZE sur WIA_PAGE_CUSTOM, la zone de sélection actuelle n’est pas affectée. Le minipilote 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 produit une zone de sélection située en dehors de la vitre du scanneur, le minipilote doit automatiquement ajuster les valeurs des propriétés WIA_IPS_XPOS et WIA_IPS_YPOS aux paramètres valides. Si les propriétés WIA_DPS_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 minipilote doit faire échouer les paramètres de l’application en renvoyant une erreur dans le IWiaMiniDrv ::d rvvalidateitemproperties. .

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

  1. Le pilote signale les paramètres.
  2. Une application définit la propriété WIA_DPS_PAGE_SIZE sur WIA_PAGE_LETTER.
  3. Une application définit la propriété WIA_IPS_ORIENTATION sur Lanscape.
  4. Une application remplace la propriété WIA_IPS_XEXTENT par une valeur inférieure.

Exemple 1 : le minipilote signale les paramètres

Dans l’exemple suivant, le minipilote définit une zone de sélection personnalisée avant qu’une application définisse des propriétés WIA. Dans ce cas, la zone de sélection représente l’ensemble du plateau.

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_WIDTH = 11500
WIA_DPS_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_DPS_PAGE_SIZE sur WIA_PAGE_LETTER

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_WIDTH = 8500
WIA_DPS_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 la propriété WIA_IPS_ORIENTATION sur Lanscape

Le lit physique doit pouvoir acquérir une page qui était à l’origine en orientation paysage.

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_HEIGHT = 11000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
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 remplace la propriété WIA_IPS_XEXTENT par une valeur inférieure

Dans l’exemple suivant, une application remplace la valeur de la propriété WIA_IPS_XEXTENT par 1000. Le minipilote doit supposer que la nouvelle valeur contenue dans WIA_IPS_XEXTENT n’est plus valide pour la propriété WIA_DPS_PAGE_SIZE et doit donc remplacer WIA_DPS_PAGE_SIZE par WIA_PAGE_CUSTOM. Le minipilote doit également ajuster WIA_DPS_PAGE_WIDTH.

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_HEIGHT = 10000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
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_DPS_PAGE_WIDTH
ScannerDevicePageWidth
[!Note]
cette propriété n’est pas prise en charge par Windows Vista. Utilisez WIA_IPS_PAGE_WIDTH.

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

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

WIA_DPS_PAGES
ScannerDevicePages
[!Note]
cette propriété n’est pas prise en charge par Windows Vista. Utilisez WIA_IPS_PAGES.

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

Type : VT_I4; Accès : lecture/écriture ; Valeurs valides : WIA_PROP_RANGE (zéro jusqu’au nombre maximal de pages que le chargeur de documents peut contenir)

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.

[!Note]
Si le mode duplex est activé (WIA_DPS_DOCUMENT_HANDLING_SELECT est défini sur alimentation | DUPLEX), WIA_DPS_PAGES est toujours égal au nombre de pages à analyser.

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

Si vous affectez la valeur 1 à WIA_DPS_PAGES , un scanneur traite l’un des côtés de la page. Si un scanneur ne parvient pas à analyser un seul côté d’une page alors qu’il est en mode duplex, le WIA_DPS_PAGES valeur valide pour le membre Inc de la structure WIA_PROPERTY_INFO doit être changée en 2. Cette valeur signale à l’application qu’elle doit demander des pages par multiples de deux. La valeur zéro signifie que toutes les pages qui sont actuellement chargées dans le chargeur de documents doivent être analysées.

WIA_DPS_PLATEN_COLOR
ScannerDevicePlatenColor

Spécifie la couleur du plateau dans l’arrière de la feuille à analyser. Cette propriété est facultative pour les scanneurs qui ont un plateau. Le minipilote crée et gère cette propriété.

Type : VT_UI1 | VT_VECTOR, Access : lecture seule, valeurs valides : WIA_PROP_NONE

Le format des informations de couleur est RGBQUAD.

WIA_DPS_PREVIEW
ScannerDevicePreview
[!Note]
cette propriété n’est pas prise en charge par Windows Vista. Utilisez WIA_IPS_PREVIEW.

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

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

Valeur Définition
WIA_FINAL_SCAN L’application effectue une analyse finale.
WIA_PREVIEW_SCAN L’application effectue une analyse de l’aperçu.

WIA_DPS_SCAN_AHEAD_PAGES
ScannerDeviceScanAheadPages

Contient une valeur qui indique si le scanneur met en cache des pages dans une mémoire tampon de scanneur avant de les envoyer à l’application.

Une valeur de zéro désactive l’analyse à l’avance et aucune page n’est analysée. Les transferts de données normaux sur l’élément d’analyse mis en mémoire tampon récupèrent les pages mises en mémoire tampon. Les propriétés WIA ne peuvent pas être modifiées lors d’une opération d’analyse anticipée. Cette propriété est facultative.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_RANGE de zéro au nombre maximal de pages que le chargeur de documents peut contenir.

WIA_DPS_SCAN_AVAILABLE_ITEM
ScannerDeviceScanAvailableItem
[!Note]
cette propriété est prise en charge uniquement par Windows 7 et versions ultérieures.

Indique la source d’entrée à partir de laquelle effectuer l’analyse, ou l’emplacement de stockage à partir duquel les données sont transférées.

Un événement d’analyse informe l’application que l’utilisateur a lancé une analyse, mais l’événement ne fournit pas le nom de l’élément WIA qui représente la source d’entrée. Le gestionnaire d’événements de l’application peut interroger la propriété de WIA_DPS_SCAN_AVAILABLE_ITEM de l’élément racine pour obtenir le nom de l’élément source d’entrée.

Type : VT_I4, Access : lecture/écriture, valeurs valides : WIA_PROP_RANGE de zéro au nombre maximal de pages que le chargeur de documents peut contenir.

WIA_DPS_SERVICE_ID
ScannerDeviceServiceId
[!Note]
cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

Contient l’ID de service d’un périphérique de scanneur de services Web. Le mini-pilote WIA 2,0 crée et gère cette propriété.

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

WIA_DPS_SHEET_FEEDER_REGISTRATION
ScannerDeviceSheetFeederRegistration
[!Note]
cette propriété n’est pas prise en charge avec Windows Vista et versions ultérieures. Utilisez WIA_IPS_SHEET_FEEDER_REGISTRATION.

Contient les détections d’alignement, d’alignement et de bord pour les documents placés sur le plateau. Le minipilote crée et gère cette propriété. Cette propriété indique comment la feuille est positionnée horizontalement sur la tête de numérisation d’un lecteur de poche ou d’un scanneur à feuille. La propriété permet de prédire où un document est placé sur l’en-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 haut. Cette propriété est obligatoire pour les scanneurs de feuille, d’alimentation et de défilement.

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

Constante Description
LEFT_JUSTIFIED La feuille est positionnée à gauche par rapport à la tête de numérisation.
PARTANT La feuille est centrée sur la tête de numérisation.
RIGHT_JUSTIFIED La feuille est positionnée à droite par rapport à la tête de numérisation.

WIA_DPS_SHOW_PREVIEW_CONTROL
ScannerDeviceShowPreviewControl
[!Note]
cette propriété n’est pas prise en charge par Windows Vista. Utilisez WIA_IPS_SHOW_PREVIEW_CONTROL.

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

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

Constante Description
WIA_SHOW_PREVIEW_CONTROL Affichez un contrôle d’aperçu pour l’utilisateur, car ce dernier peut effectuer une préversion.
WIA_DONT_SHOW_PREVIEW_CONTROL N’affiche pas un contrôle d’aperçu pour l’utilisateur, car cet appareil ne peut pas effectuer d’aperçu.

WIA_DPS_USER_NAME
ScannerDeviceUserName
[!Note]
cette propriété est prise en charge uniquement par Windows Vista et versions ultérieures.

Utilisé par le service WIA pour informer le mini-pilote du nom du compte d’utilisateur (y compris le nom de domaine réseau, le cas échéant) de la session dans laquelle l’application WIA en cours est en cours d’exécution.

Il s’agit d’une propriété d’élément racine, gérée par le service WIA.

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

WIA_DPS_VERTICAL_BED_REGISTRATION
ScannerDeviceVerticalBedRegistration
[!Note]
cette propriété n’est pas prise en charge avec Windows Vista et versions ultérieures.

Contient l’inscription, ou l’alignement vertical et la détection des bords, pour les documents placés sur le plateau. Le minipilote crée et gère cette propriété.

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

Constante Description
TOP_JUSTIFIED Le papier est aligné en haut.
PARTANT Le papier est centré.
BOTTOM_JUSTIFIED Le papier est justifié en bas.

Voir aussi.

WIA_DPS_HORIZONTAL_BED_REGISTRATION

WIA_DPS_VERTICAL_BED_SIZE
ScannerDeviceVerticalBedSize
[!Note]
cette propriété n’est pas prise en charge avec Windows Vista et versions ultérieures. Utilisez WIA_IPS_MAX_VERTICAL_SIZE.

Spécifie la hauteur maximale, en millièmes de pouce, qui est analysée sur l’axe vertical (Y) à partir du plateau d’un scanneur à plat dans la résolution actuelle. Cette propriété s’applique également aux alimentations automatiques de documents, qui déplacent les feuilles vers le plateau d’un scanneur à plat à des fins de numérisation. Cette propriété est obligatoire pour les scanneurs qui ont un plateau. À la place, les autres types de scanneurs implémentent la propriété WIA_DPS_VERTICAL_SHEET_FEED_SIZE .

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

WIA_DPS_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceVerticalSheetFeedSize
[!Note]
cette propriété n’est pas prise en charge avec Windows Vista et versions ultérieures. Utilisez WIA_IPS_MAX_VERTICAL_SIZE.

Spécifie la hauteur maximale, en millièmes de pouce, qui est numérisée sur l’axe vertical (Y) à partir d’un scanneur de papier portable ou de feuille à la résolution actuelle. Cette propriété s’applique également aux alimentations automatiques de documents qui analysent sans déplacer les feuilles vers le plateau d’un scanneur à plat. Cette propriété est obligatoire pour les scanneurs feuille à alimentation. Les scanneurs à défilement et les scanneurs de la main ne doivent pas implémenter cette propriété.

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

Configuration requise

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