Estrutura SCANINFO (wiamicro.h)
A estrutura SCANINFO é usada para armazenar e comunicar informações sobre uma aquisição de verificação. O Driver Flatbed do WIA lê valores da estrutura SCANINFO, mas nunca grava valores. É responsabilidade do microdriver definir valores para os membros SCANINFO.
Sintaxe
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;
Membros
ADF
Indica se o verificador dá suporte a um ADF (alimentador automático de documentos). Esse membro pode ser um dos seguintes valores:
| Valor | Significado |
|---|---|
| 0 | O scanner não dá suporte a um ADF. |
| 1 | O scanner dá suporte a um ADF. |
| 2 | O scanner dá suporte a um ADF com funcionalidade duplex. |
TPA
Indica se o verificador dá suporte a TPA (Adaptador TransParency). O valor pode ser:
0 – sem suporte
1 – com suporte
Endorser
Indica se o verificador tem funcionalidades de endosso. O valor pode ser:
0 – sem suporte
1 – com suporte
OpticalXResolution
Especifica a configuração de dpi horizontal da ótica do scanner.
OpticalYResolution
Especifica a configuração de dpi vertical da ótica do scanner.
BedWidth
Especifica a largura da cama do scanner em milésimos de polegada.
BedHeight
Especifica a altura da cama do scanner em milésimos de polegada.
IntensityRange
Especifica os valores de intervalo de intensidade/brilho do verificador.
ContrastRange
Especifica os valores de intervalo de contraste do verificador.
SupportedCompressionType
Especifica um valor de máscara de tipos de compactação com suporte. Um valor zero indica que não há suporte para tipos de compactação.
SupportedDataTypes
Especifica um valor de máscara de tipos de dados com suporte. Um valor zero indica que não há suporte para tipos de dados. Esse membro pode ser o OR bit a bit do seguinte.
| Valor | Significado |
|---|---|
| SUPPORT_BW | A imagem é 1 bit por pixel preto e branco. |
| SUPPORT_COLOR | A imagem é uma cor de 24 bits por pixel. |
| SUPPORT_GRAYSCALE | A imagem é uma escala de cinza de 8 bits por pixel. |
WidthPixels
Especifica a largura da imagem atual em pixels.
WidthBytes
Especifica a largura da imagem atual em bytes.
Lines
Especifica a altura da imagem atual em pixels.
DataType
Especifica o conjunto de tipos de dados atual da imagem atual. Esse membro pode ser definido como um dos seguintes.
| Valor | Significado |
|---|---|
| WIA_DATA_COLOR | O driver dá suporte à cor de 24 bits por pixel. |
| WIA_DATA_COLOR_DITHER | Não há suporte para esse valor no driver WiA Flatbed. |
| WIA_DATA_COLOR_THRESHOLD | Não há suporte para esse valor no driver WiA Flatbed. |
| WIA_DATA_DITHER | Não há suporte para esse valor no driver WiA Flatbed. |
| WIA_DATA_GRAYSCALE | O driver dá suporte à escala de cinza de 8 bits por pixel. |
| WIA_DATA_THRESHOLD | O driver dá suporte a 1 bit por pixel preto e branco. |
PixelBits
Especifica a configuração de profundidade de bit atual da imagem atual.
Intensity
Especifica a configuração de intensidade/brilho atual do scanner.
Contrast
Especifica a configuração de contraste atual do verificador.
Xresolution
Especifica a configuração de dpi horizontal da ótica do scanner.
Yresolution
Especifica a configuração de dpi vertical da ótica do scanner.
Window
Especifica as configurações atuais da janela do scanner.
DitherPattern
Especifica o padrão dither do scanner.
Negative
Especifica se o negativo está ativado ou desativado. O valor pode ser:
0 - desativado
1 - em
Mirror
Especifica se espelho está ativada ou desativada. O valor pode ser:
0 - desativado
1 - em
AutoBack
Especifica se o AutoBack está ativado ou desativado. O valor pode ser:
0 - desativado
1 - em
ColorDitherPattern
Reservado. Defina como zero.
ToneMap
Reservado. Defina como zero.
Compression
Especifica se a compactação está ativada ou desativada para o verificador. O valor pode ser:
0 - desativado
1 - em
RawDataFormat
Especifica o formato de dados brutos para o verificador. O valor pode ser:
0 – dados empacotados
1 – dados planares
RawPixelOrder
Especifica a ordem de pixel para o verificador. O valor pode ser:
0 - RGB
1 – BGR
bNeedDataAlignment
Especifica se o alinhamento de dados é necessário para o verificador. O valor pode ser:
0 - false
1 – true
DelayBetweenRead
Especifica o atraso de tempo em milissegundos entre as chamadas de função de verificação que o verificador pode dar suporte.
MaxBufferSize
Especifica o tamanho máximo do buffer no verificador.
DeviceIOHandles[MAX_IO_HANDLES]
Especifica uma matriz de identificadores de E/S do dispositivo necessários para a comunicação do dispositivo.
lReserved[MAX_RESERVED]
Especifica uma matriz de bits reservados.
pMicroDriverContext
Aponta para o contexto do microdriver. O microdriver aloca o buffer apontado por esse membro. O buffer deve ser alocado em CMD_INITIALIZE e liberado em CMD_UNINITIALIZE. (Consulte Comandos obrigatórios.) O driver wia flatbed não sabe nada desse ponteiro e, portanto, não alterará a memória apontada por esse membro.
Comentários
Essa estrutura é usada como um parâmetro nas funções SetPixelWindow e Scan do microdriver.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | wiamicro.h (inclua Wiamicro.h) |