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)

Confira também

Varredura

SetPixelWindow