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 chargeur de documents automatique (ADF). Ce membre peut être l’une des valeurs suivantes :
| Valeur | Signification |
|---|---|
| 0 | Le scanneur ne prend pas en charge un ADF. |
| 1 | Le scanneur prend en charge un ADF. |
| 2 | Le scanneur prend en charge un ADF avec la fonctionnalité duplex. |
TPA
Indique si le scanneur prend en charge TPA (TransParency Adapter). La valeur peut être :
0 - non pris en charge
1 - pris en charge
Endorser
Indique si le scanneur dispose de fonctionnalités d’approbation. 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 de 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 le OR au niveau du bit de ce qui suit.
| Valeur | Signification |
|---|---|
| SUPPORT_BW | L’image est noir et blanc 1 bit par pixel. |
| SUPPORT_COLOR | L’image a une couleur de 24 bits par pixel. |
| SUPPORT_GRAYSCALE | L’image a une échelle de gris de 8 bits par 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 type 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 des niveaux de gris de 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é actuel 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 négatif est activé ou désactivé. La valeur peut être :
0 - désactivé
1 - sur
Mirror
Spécifie si miroir est activé ou désactivé. La valeur peut être :
0 - désactivé
1 - sur
AutoBack
Spécifie si la restauration automatique est activée ou désactivée. La valeur peut être :
0 - désactivé
1 - sur
ColorDitherPattern
Réservé. Définit la valeur zéro.
ToneMap
Réservé. Définit la valeur 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 - sur
RawDataFormat
Spécifie le format de données brutes pour le scanneur. La valeur peut être :
0 - données empaquetées
1 - données planaires
RawPixelOrder
Spécifie l’ordre de 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 les appels de fonction d’analyse 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 en 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 SetPixelWindow et Scan du microdriver.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | wiamicro.h (inclure Wiamicro.h) |