Partager via


Constantes de propriété d’appareil du scanneur

Les périphériques matériels d’acquisition d’images Windows (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 appareils scanneurs et est la convention de nommage utilisée en 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 en regard du nom de la constante C/C++ dans la liste suivante.

Constante/valeur Description
WIA_DPS_DEVICE_ID
ScannerDeviceDeviceId
Remarque :
Cette propriété est prise en charge uniquement sur Windows Vista et versions ultérieures.


Contient une fonction unique instance identificateur pour un appareil d’analyseur de services web. Cet identificateur représente le service web sur le périphérique scanneur avec lequel le mini-pilote WIA communique. Aucune hypothèse concernant 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 rechercher, à l’aide de l’API de découverte de fonction, l’objet instance de fonction représentant l’appareil d’analyse des services web 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 minidriver crée et gère cette propriété.
Une application lit cette propriété pour déterminer si le scanneur dispose d’un lit plat, d’un chargeur de documents ou d’un duplexeur. Cette propriété est également utilisée pour définir davantage les fonctionnalités installées.
Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE
Le tableau suivant décrit les constantes valides avec Windows 7 uniquement.
Indicateurs Description
AUTO_SOURCE Un gestionnaire de documents automatique est installé dans le scanneur.

 

Le tableau suivant décrit les constantes 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 des configurations duplex de base et avancées.
DETECT_FILM_TPA Le scanneur peut détecter quand l’adaptateur de transparence/film est prêt à être analysé.
DETECT_STOR Le scanneur peut détecter quand des documents se trouvent dans le stockage interne.
FILM_TPA Le scanneur est équipé d’un adaptateur de balayage transparence/film.
STOR Le scanneur est équipé d’un périphérique de stockage d’images interne.

 

Le tableau suivant décrit les constantes 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 la plaque à plat.
DETECT_SCAN Le scanneur peut détecter un document dans le chargeur uniquement en analysant.
DUP Le scanneur dispose d’un duplexeur.
NOURRIR Un gestionnaire de documents automatique est installé dans le scanneur.
PLAT Le scanneur a une plaque à plat.

 

Le tableau suivant décrit les constantes 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 l’utilisateur.
DETECT_DUP_AVAIL Le scanneur peut indiquer quand le duplexeur est installé.
DETECT_FEED_AVAIL Le scanneur peut indiquer quand le chargeur de documents automatique est installé.

 

WIA_DPS_DOCUMENT_HANDLING_SELECT
ScannerDeviceDocumentHandlingSelect

Remarque :
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 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, Access : Lecture/écriture, Valeurs valides : WIA_PROP_FLAG

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

Indicateurs Description
ALIMENTATION Analysez à l’aide du chargeur de documents.
PLAT Analysez à l’aide du lit plat.
DUPLEX Analysez à l’aide d’opérations de duplexeur.
AUTO_ADVANCE Active l’alimentation automatique du document suivant après une analyse.
FRONT_FIRST Commencez par analyser l’avant du document. Cette valeur est valide lorsque DUPLEX est défini.
BACK_FIRST Commencez par analyser l’arrière du document. Cette valeur est valide lorsque DUPLEX est défini.
FRONT_ONLY Analysez le front uniquement. Cette valeur est valide lorsque DUPLEX est défini.
BACK_ONLY Analysez l’arrière uniquement. Cette valeur est valide lorsque DUPLEX est défini.
NEXT_PAGE Analysez la page suivante du document.
PREFEED 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 lit plat, du chargeur de documents ou du duplexeur installé par le scanneur. Le minidriver crée et gère cette propriété.

Une application lit cette propriété pour déterminer si l’appareil d’analyse est prêt à être utilisé. Il s’agit d’un moyen idéal de case activée si le papier se trouve 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 lit plat est prêt à être utilisé.
FLAT_READY Le scanneur a un document sur la plaque à plat.
DUP_READY Le duplexeur est activé et prêt à être utilisé.
FLAT_COVER_UP La couverture de lit plat est en place.
PATH_COVER_UP Le chemin d’accès papier est couvert et empêche le bon fonctionnement.
PAPER_JAM Un document est bloqué dans le chargeur de documents.
FILM_TPA_READYV L’adaptateur de transparence est installé et prêt à être utilisé.
STORAGE_READYV Le périphérique de stockage interne est prêt.
STORAGE_FULLV Le stockage est plein, aucune opération de chargement possible.
MULTIPLE_FEEDV Une condition de flux multiple s’est produite (généralement avec un PAPER_JAM).
DEVICE_ATTENTIONV Une erreur nécessite l’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’approbation valides. Un endosseur est une imprimante installée sur un scanneur qui imprime un message texte sur chaque page analysée. Le minidriver doit valider le paramètre de la propriété WIA_DPS_ENDORSER_STRING par rapport au jeu de caractères valide dans cette propriété. Le minidriver 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 que le minidriver scanne. 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 minidriver doit approuver les documents uniquement si une chaîne est définie dans cette propriété. Une chaîne vide signifie que la fonctionnalité d’approbation est désactivée.

Étant donné qu’il incombe au pilote d’interpréter la chaîne d’approbation, votre pilote peut utiliser des caractères spéciaux dans WIA_DPS_ENDORSER_STRING. Toutefois, seules vos applications comprendraient ces caractères.

Type : VT_BSTR, Access : Lecture/écriture, Valeurs valides : WIA_PROP_NONE

Un pilote prenant 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 sous la forme DD.
$MONTH$ Mois de l’année sous la forme MM.
$PAGE_COUNT$ Nombre de pages transférées.
$TIME$ Heure de la journée sous la forme HH:MM:SS.
$YEAR$ Année sous la forme AAAA.

 

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

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

 

Contient l’adresse SOAP d’un appareil d’analyseur 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

Remarque :
Cette propriété n’est pas prise en charge avec Windows Vista et versions ultérieures.

 

Contient l’inscription, ou l’alignement horizontal, pour les documents placés sur le plateau. Le minidriver 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é.

Constant Description
LEFT_JUSTIFIED Le papier est laissé justifié.
CENTRÉ Le papier est centré.
RIGHT_JUSTIFIED Le papier est justifié à juste raison.

 

Voir aussi

WIA_DPS_VERTICAL_BED_REGISTRATION

WIA_DPS_HORIZONTAL_BED_SIZE
ScannerDeviceHorizontalBedSize

Remarque :
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 analysée dans l’axe horizontal (X) à partir de la plaque d’un scanneur à plat à la résolution actuelle. Cette propriété s’applique également aux chargeurs de documents automatiques qui déplacent des feuilles vers la plaque d’un scanneur à plat pour la numérisation. Cette propriété est obligatoire pour les scanneurs qui ont une plaque. D’autres types d’analyseur implémentent plutôt 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

Remarque :
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 analysée dans l’axe horizontal (X) à partir d’un scanneur de flux de poche ou de feuille à la résolution actuelle. Cette propriété s’applique également aux chargeurs de documents automatiques qui scannent sans déplacer les feuilles vers la plaque d’un scanneur à plat. Cette propriété est obligatoire pour les scanneurs à feuilles, à défilement et à main.

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 seule page 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 lors de la détermination des conditions d’un appareil qui a cessé de répondre. Le minidriver crée et gère cette propriété. Cette propriété est requise pour tous les scanneurs.

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

WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceMinHorizontalSheetFeedSize

Remarque :
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 minidriver 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

Remarque :
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 minidriver 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

Remarque :
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 dans DPI. 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. 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 scanneurs.

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

WIA_DPS_OPTICAL_YRES
ScannerDeviceOpticalYres

Remarque :
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 dans DPI. 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 scanneurs.

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

WIA_DPS_ORIENTATION
ScannerDeviceOrientation

Contient le paramètre d’orientation actuel. Le minidriver 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 Defination
PAYSAGE Rotation à 90 degrés dans le sens des aiguilles d’une montre, par rapport à l’orientation PORTRAIT.
PORTRAIT 0 degrés.
ROT180 Rotation à 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 des aiguilles d’une montre, par rapport à l’orientation PORTRAIT.

 

Voir aussi

WIA_IPS_ROTATION

WIA_DPS_PAD_COLOR
ScannerDevicePadColor

Couleur utilisée pour le remplissage lorsque les données d’image ne sont pas suffisantes pour remplir une mémoire tampon demandée. Cette propriété est implémentée pour les scanneurs qui padmentent la mémoire tampon. Cette propriété est facultative pour tous les scanneurs. Le minidriver crée et gère cette propriété.

Type : VT_UI1 | VT_VECTOR, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE

Le format des informations de couleur est RGBQUAD.

WIA_DPS_PAGE_HEIGHT
ScannerDevicePageHeight

Remarque :
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 minidriver 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 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_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

Remarque :
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 minidriver 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 indiquent les dimensions de la page, en millièmes de pouce. Notez que ces propriétés doivent être en accord 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 des documents orientés paysage avec un paramètre de 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 est défini sur LANSCAPE.

Si une application définit WIA_DPS_PAGE_SIZE sur une valeur autre que WIA_PAGE_CUSTOM, le minidriver doit ajuster les valeurs de WIA_DPS_PAGE_WIDTH et WIA_DPS_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’étendue (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_DPS_PAGE_SIZE en WIA_PAGE_CUSTOM. Le minidriver doit également modifier WIA_DPS_PAGE_WIDTH ou WIA_DPS_PAGE_HEIGHT en fonction du nouveau paramètre d’étendue.

Si WIA_IPS_ORIENTATION est défini sur LANSCAPE, les paramètres d’étendue seront « retournés ». Par exemple, si une application définit WIA_DPS_PAGE_SIZE sur WIA_PAGE_A4, le minidriver doit définir WIA_DPS_PAGE_WIDTH sur 11692 et WIA_DPS_PAGE_HEIGHT sur 8267. (Le minidriver 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 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_DPS_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_DPS_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 aboutit à une zone de sélection située à l’extérieur du lit du scanneur, le mini-lecteur doit ajuster automatiquement les valeurs des propriétés WIA_IPS_XPOS et WIA_IPS_YPOS à des 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 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_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 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_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_SIZEsur 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_ORIENTATIONsur LANSCAPE

Le lit physique doit être en mesure d’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 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_DPS_PAGE_SIZE et doit donc remplacer WIA_DPS_PAGE_SIZE par WIA_PAGE_CUSTOM. Le minidriver 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

Remarque :
Cette propriété n’est pas prise en charge par Windows Vista. Utilisez WIA_IPS_PAGE_WIDTH.

 

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_DPS_PAGE_SIZE est définie sur WIA_PAGE_CUSTOM. WIA_DPS_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é.

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

WIA_DPS_PAGES
ScannerDevicePages

Remarque :
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 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 (zéro dans le 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.

Remarque :
Si le mode duplex est activé (WIA_DPS_DOCUMENT_HANDLING_SELECT est défini sur FEEDER | DUPLEX ), WIA_DPS_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.

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

WIA_DPS_PLATEN_COLOR
ScannerDevicePlatenColor

Spécifie la couleur de la plaque à l’arrière de la feuille à analyser. Cette propriété est facultative pour les scanneurs qui ont une plaque. Le minidriver crée et gère cette propriété.

Type : VT_UI1 | VT_VECTOR, Accès : Lecture seule, Valeurs valides : WIA_PROP_NONE

Le format des informations de couleur est RGBQUAD.

WIA_DPS_PREVIEW
ScannerDevicePreview

Remarque :
Cette propriété n’est pas prise en charge par Windows Vista. Utilisez WIA_IPS_PREVIEW.

 

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.

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

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

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

 

WIA_DPS_SCAN_AHEAD_PAGES
ScannerDeviceScanAheadPages

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

La valeur zéro désactive l’analyse à l’avance et aucune page ne sera analysée à l’avance. L’exécution de transferts de données normaux sur l’élément d’analyse en mémoire tampon récupère 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, Accès : 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

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

 

Indique la source d’entrée (à plat, chargeur automatique de documents ou adaptateur de numérisation de fil) à partir de laquelle effectuer l’analyse, ou l’emplacement de stockage à partir duquel transférer des donné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é 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, Accès : 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

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

 

Contient l’ID de service d’un appareil 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

Remarque :
Cette propriété n’est pas prise en charge avec Windows Vista et versions ultérieures. Utilisez WIA_IPS_SHEET_FEEDER_REGISTRATION.

 

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 de balayage d’un scanneur à main ou à feuilles. 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 de balayage, cette propriété est relative à la tête de balayage la plus haute. Cette propriété est obligatoire pour les scanneurs à feuilles, à défilement et à main.

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

Le tableau suivant contient les trois constantes 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_DPS_SHOW_PREVIEW_CONTROL
ScannerDeviceShowPreviewControl

Remarque :
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é à l’utilisateur. Le minidriver crée et gère cette propriété.

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

Le tableau suivant contient les deux constantes 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 d’aperçu.

 

WIA_DPS_USER_NAME
ScannerDeviceUserName

Remarque :
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 actuelle 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

Remarque :
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 de bord, pour les documents placés sur le plat. Le minidriver crée et gère cette propriété.

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

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

Constant Description
TOP_JUSTIFIED Le papier est le plus justifié.
CENTRÉ 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

Remarque :
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 dans l’axe vertical (Y) à partir de la plaque d’un scanneur à plat à la résolution actuelle. Cette propriété s’applique également aux chargeurs automatiques de documents, qui déplacent les feuilles vers la plaque d’un scanneur à plat pour la numérisation. Cette propriété est obligatoire pour les scanneurs qui ont une plaque. D’autres types de scanneurs implémentent à la place la propriété WIA_DPS_VERTICAL_SHEET_FEED_SIZE .

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

WIA_DPS_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceVerticalSheetFeedSize

Remarque :
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 dans l’axe vertical (Y) à partir d’un scanneur de flux de poche ou de feuille à la résolution actuelle. Cette propriété s’applique également aux chargeurs automatiques de documents qui scannent sans déplacer les feuilles sur la plaque d’un scanneur à plat. Cette propriété est obligatoire pour les scanneurs à feuilles. Les scanneurs à défilement et à main ne doivent pas implémenter cette propriété.

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

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