Estrutura SCANINFO (wiamicro.h)
A estrutura SCANINFO é usada para armazenar e comunicar informações sobre uma aquisição de verificação. O Driver Flatbed 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 (TransParency Adapter). O valor pode ser:
0 – sem suporte
1 – com suporte
Endorser
Indica se o scanner 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 verificador em milésimos de polegada.
BedHeight
Especifica a altura da cama do verificador 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 tem 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 a 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 verificador.
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 verificador.
DitherPattern
Especifica o padrão dither do verificador.
Negative
Especifica se o negativo está ativado ou desativado. O valor pode ser:
0 – desativado
1 - ativado
Mirror
Especifica se o espelho está ativado ou desativado. O valor pode ser:
0 – desativado
1 - ativado
AutoBack
Especifica se o AutoBack está ativado ou desativado. O valor pode ser:
0 – desativado
1 - ativado
ColorDitherPattern
Reservado. Definido como zero.
ToneMap
Reservado. Definido como zero.
Compression
Especifica se a compactação está ativada ou desativada para o verificador. O valor pode ser:
0 – desativado
1 - ativado
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 verificação chamadas de funçã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 necessários.) O driver WIA Flatbed não sabe nada desse ponteiro e, portanto, não alterará a memória apontada por esse membro.
Observações
Essa estrutura é usada como um parâmetro nas funções SetPixelWindowdo microdriver e Verificação.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | wiamicro.h (inclua Wiamicro.h) |