Structure SCANINFO (wiamicro.h)
La structure SCANINFO est utilisée pour stocker et communiquer des informations sur une acquisition d’analyse. Le pilote à plat WIA lit les valeurs de la structure SCANINFO, mais n’écrit jamais de valeurs. Il incombe au microdriver de définir des valeurs pour les membres SCANINFO.
Syntaxe
typedef struct _SCANINFO {
LONG ADF;
LONG TPA;
LONG Endorser;
LONG OpticalXResolution;
LONG OpticalYResolution;
LONG BedWidth;
LONG BedHeight;
RANGEVALUE IntensityRange;
RANGEVALUE ContrastRange;
LONG SupportedCompressionType;
LONG SupportedDataTypes;
LONG WidthPixels;
LONG WidthBytes;
LONG Lines;
LONG DataType;
LONG PixelBits;
LONG Intensity;
LONG Contrast;
LONG Xresolution;
LONG Yresolution;
SCANWINDOW Window;
LONG DitherPattern;
LONG Negative;
LONG Mirror;
LONG AutoBack;
LONG ColorDitherPattern;
LONG ToneMap;
LONG Compression;
LONG RawDataFormat;
LONG RawPixelOrder;
LONG bNeedDataAlignment;
LONG DelayBetweenRead;
LONG MaxBufferSize;
HANDLE DeviceIOHandles[MAX_IO_HANDLES];
LONG lReserved[MAX_RESERVED];
VOID *pMicroDriverContext;
} SCANINFO, *PSCANINFO;
Membres
ADF
Indique si le scanneur prend en charge un flux de documents automatique (ADF). Ce membre peut être l’une des valeurs suivantes :
| Valeur | Signification |
|---|---|
| 0 | Le scanneur ne prend pas en charge une fonction ADF. |
| 1 | Le scanneur prend en charge une fonction ADF. |
| 2 | Le scanneur prend en charge une fonction ADF avec une fonctionnalité duplex. |
TPA
Indique si le scanneur prend en charge TPA (adaptateur de transparency). La valeur peut être :
0 - non pris en charge
1 - pris en charge
Endorser
Indique si le scanneur dispose de fonctionnalités d’avalisateur. La valeur peut être :
0 - non pris en charge
1 - pris en charge
OpticalXResolution
Spécifie le paramètre ppp horizontal de l’optique du scanneur.
OpticalYResolution
Spécifie le paramètre ppp vertical de l’optique du scanneur.
BedWidth
Spécifie la largeur du lit du scanneur en millièmes de pouce.
BedHeight
Spécifie la hauteur du lit du scanneur en millièmes de pouce.
IntensityRange
Spécifie les valeurs de plage d’intensité/luminosité du scanneur.
ContrastRange
Spécifie les valeurs de plage de contraste du scanneur.
SupportedCompressionType
Spécifie une valeur de masque des types de compression pris en charge. La valeur zéro indique qu’aucun type de compression n’est pris en charge.
SupportedDataTypes
Spécifie une valeur de masque des types de données pris en charge. La valeur zéro indique qu’aucun type de données n’est pris en charge. Ce membre peut être l’OR au niveau du bit des éléments suivants.
| Valeur | Signification |
|---|---|
| SUPPORT_BW | L’image est de 1 bit par pixel noir et blanc. |
| SUPPORT_COLOR | L’image est de 24 bits par pixel. |
| SUPPORT_GRAYSCALE | L’image est de 8 bits par nuance de gris pixel. |
WidthPixels
Spécifie la largeur de l’image actuelle en pixels.
WidthBytes
Spécifie la largeur de l’image actuelle en octets.
Lines
Spécifie la hauteur de l’image actuelle en pixels.
DataType
Spécifie le jeu de types de données actuel de l’image actuelle. Ce membre peut être défini sur l’un des éléments suivants.
| Valeur | Signification |
|---|---|
| WIA_DATA_COLOR | Le pilote prend en charge la couleur 24 bits par pixel. |
| WIA_DATA_COLOR_DITHER | Cette valeur n’est pas prise en charge dans le pilote WIA Flatbed. |
| WIA_DATA_COLOR_THRESHOLD | Cette valeur n’est pas prise en charge dans le pilote WIA Flatbed. |
| WIA_DATA_DITHER | Cette valeur n’est pas prise en charge dans le pilote WIA Flatbed. |
| WIA_DATA_GRAYSCALE | Le pilote prend en charge les nuances de gris 8 bits par pixel. |
| WIA_DATA_THRESHOLD | Le pilote prend en charge 1 bit par pixel noir et blanc. |
PixelBits
Spécifie le paramètre de profondeur de bits actuel de l’image actuelle.
Intensity
Spécifie le paramètre d’intensité/luminosité actuelle du scanneur.
Contrast
Spécifie le paramètre de contraste actuel du scanneur.
Xresolution
Spécifie le paramètre ppp horizontal de l’optique du scanneur.
Yresolution
Spécifie le paramètre ppp vertical de l’optique du scanneur.
Window
Spécifie les paramètres actuels de la fenêtre du scanneur.
DitherPattern
Spécifie le modèle de trame du scanneur.
Negative
Spécifie si la valeur négative est activée ou désactivée. La valeur peut être :
0 - désactivé
1 - on
Mirror
Spécifie si le miroir est activé ou désactivé. La valeur peut être :
0 - désactivé
1 - on
AutoBack
Spécifie si la restauration automatique est activée ou désactivée. La valeur peut être :
0 - désactivé
1 - on
ColorDitherPattern
Réservé. Défini sur zéro.
ToneMap
Réservé. Défini sur zéro.
Compression
Spécifie si la compression est activée ou désactivée pour le scanneur. La valeur peut être :
0 - désactivé
1 - on
RawDataFormat
Spécifie le format de données brutes du scanneur. La valeur peut être :
0 - Données packées
1 - Données planaires
RawPixelOrder
Spécifie l’ordre des pixels du scanneur. La valeur peut être :
0 - RVB
1 - BGR
bNeedDataAlignment
Spécifie si l’alignement des données est nécessaire pour le scanneur. La valeur peut être :
0 - false
1 - true
DelayBetweenRead
Spécifie le délai en millisecondes entre scan fonction que le scanneur peut prendre en charge.
MaxBufferSize
Spécifie la taille maximale de la mémoire tampon dans le scanneur.
DeviceIOHandles[MAX_IO_HANDLES]
Spécifie un tableau de handles d’E/S d’appareil nécessaires pour la communication de l’appareil.
lReserved[MAX_RESERVED]
Spécifie un tableau de bits réservés.
pMicroDriverContext
Pointe vers le contexte du microdriver. Le microdriver alloue la mémoire tampon pointée par ce membre. La mémoire tampon doit être allouée dans CMD_INITIALIZE et libérée dans CMD_UNINITIALIZE. (Consultez Commandes requises.) Le pilote WIA Flatbed ne connaît rien de ce pointeur et ne modifie donc pas la mémoire pointée par ce membre.
Remarques
Cette structure est utilisée comme paramètre dans les fonctions de SetPixelWindowdu microdriver et Scan.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | wiamicro.h (include Wiamicro.h) |