Compartilhar via

Constantes de propriedade do dispositivo scanner

  • Artigo

Os dispositivos de hardware WIA (Aquisição de Imagens do Windows) têm valores de propriedade armazenados no Registro do Windows. Para obter mais informações, confira Constantes comuns de propriedade do dispositivo. As seguintes constantes de propriedade do dispositivo, com suas cadeias de caracteres associadas, são específicas para scanners de imagem digital.

O prefixo "WIA_DPS_" indica uma Propriedade de Dispositivo para dispositivos Scanner e é a convenção de nomenclatura usada em C/C++. Para fins de script, essas constantes usam o prefixo "ScannerDevice" e fazem parte do tipo enumerado WiaItemPropertyId . O nome do membro correspondente dessa enumeração de script aparece entre parênteses ao lado do nome da constante C/C++ na lista a seguir.

Constante/valor Descrição
WIA_DPS_DEVICE_ID
ScannerDeviceDeviceId
 Observação:
Essa propriedade tem suporte apenas no Windows Vista e posteriores.


Contém um identificador de instância de função exclusivo para um dispositivo de scanner de serviços Web. Esse identificador representa o serviço Web no dispositivo scanner com o qual o mini driver WIA está se comunicando. Nenhuma suposição sobre a forma desse identificador deve ser feita. O mini driver WIA cria e mantém essa propriedade.
Os aplicativos WIA podem usar o valor de WIA_DPS_DEVICE_ID para localizar, usando a API de Descoberta de Funções, o objeto de instância de função que representa o dispositivo verificador de serviços Web usado na sessão wia 2.0 atual.
Tipo: VT_BSTR, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE
WIA_DPS_DITHER_PATTERN_DATA
 Reservado, não use.
Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE
WIA_DPS_DITHER_SELECT
 Reservado, não use.
Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE
WIA_DPS_DOCUMENT_HANDLING_CAPABILITIES
ScannerDeviceDocumentHandlingCapabilities
 Contém os recursos do verificador. O minidriver cria e mantém essa propriedade.
Um aplicativo lê essa propriedade para determinar se o scanner tem um flatbed, um alimentador de documentos ou um duplexer instalado. Essa propriedade também é usada para definir ainda mais os recursos instalados.
Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE
A tabela a seguir descreve as constantes válidas somente com o Windows 7.
Flags Descrição
AUTO_SOURCE O verificador tem um manipulador de documentos automático instalado.

 

A tabela a seguir descreve as constantes que são válidas somente com o Windows 7 e o Windows Vista.

Flags Descrição
ADVANCED_DUP O dispositivo dá suporte à configuração avançada de verificação duplex. Use WIA_IPS_DUPLEX_SETTINGS para alternar entre o uso de configurações duplex básicas e avançadas.
DETECT_FILM_TPA O verificador pode detectar quando o adaptador de transparência/filme está pronto para verificação.
DETECT_STOR O verificador pode detectar quando há documentos no armazenamento interno.
FILM_TPA O verificador é equipado com um adaptador de verificação de transparência/filme.
STOR O scanner é equipado com um dispositivo de armazenamento de imagens interno.

 

A tabela a seguir descreve as constantes que são válidas com o Windows XP ou posterior.

Flags Descrição
DETECT_FEED O verificador pode detectar um documento no alimentador.
DETECT_FLAT O verificador pode detectar um documento no painel de base.
DETECT_SCAN O verificador só pode detectar um documento no alimentador por meio da verificação.
DUP O scanner tem um duplexer.
ALIMENTAR O verificador tem um manipulador de documentos automático instalado.
PLANA O scanner tem uma placa de flatbed.

 

A tabela a seguir descreve as constantes que são válidas somente com o Windows XP. Esses valores foram preteridos para Windows 7 e Windows Vista e não devem ser usados.

Flags Descrição
DETECT_DUP O verificador pode detectar uma solicitação de verificação duplex do usuário.
DETECT_DUP_AVAIL O verificador pode saber quando o duplexer está instalado.
DETECT_FEED_AVAIL O verificador pode informar quando o alimentador de documentos automático está instalado.

 
WIA_DPS_DOCUMENT_HANDLING_SELECT
ScannerDeviceDocumentHandlingSelect

Observação:
Não há suporte para essa propriedade no Windows Vista e posteriores. Use WIA_IPS_DOCUMENT_HANDLING_SELECT.

 

Contém a origem e o modo de aquisição do scanner atual. O minidriver cria e mantém essa propriedade.

Um aplicativo lê essa propriedade para determinar a fonte de aquisição atual do verificador ou para gravar essa propriedade para definir a origem e o modo do verificador. Além disso, os aplicativos usam essa propriedade para habilitar e desabilitar a funcionalidade duplexer.

Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_FLAG

A tabela a seguir tem as dez constantes que são válidas com essa propriedade.

Flags Descrição
ALIMENTADOR Verifique usando o alimentador de documentos.
MESA Verifique usando o flatbed.
DUPLEX Examinar usando operações duplexer.
AUTO_ADVANCE Habilita a alimentação automática do próximo documento após uma verificação.
FRONT_FIRST Primeiro, examine a frente do documento. Esse valor é válido quando DUPLEX é definido.
BACK_FIRST Examine a parte de trás do documento primeiro. Esse valor é válido quando DUPLEX é definido.
FRONT_ONLY Verifique somente a parte frontal. Esse valor é válido quando DUPLEX é definido.
BACK_ONLY Verifique somente a parte de trás. Esse valor é válido quando DUPLEX é definido.
NEXT_PAGE Examine a próxima página do documento.
PREFEED Habilitar o modo de pré-feed. Pré-posicionar o próximo documento durante a verificação.

 
WIA_DPS_DOCUMENT_HANDLING_STATUS
ScannerDeviceDocumentHandlingStatus

Contém o estado atual do flatbed instalado do scanner, do alimentador de documentos ou do duplexer. O minidriver cria e mantém essa propriedade.

Um aplicativo lê essa propriedade para determinar se o dispositivo de scanner está pronto para ser usado. Essa é uma maneira ideal de marcar se o papel está no alimentador antes de adquirir uma imagem.

Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE

A tabela a seguir tem as constantes que são válidas com essa propriedade. Um asterisco * indica que o sinalizador não tem suporte no Windows Vista ou posterior. O símbolo V indica que o sinalizador tem suporte apenas no Windows Vista e posterior.

Flags Descrição
FEED_READY O flatbed está pronto para uso.
FLAT_READY O scanner tem um documento no painel de base.
DUP_READY O duplexer está habilitado e pronto para ser usado.
FLAT_COVER_UP A cobertura da cama plana está para cima.
PATH_COVER_UP O caminho do papel é coberto e está impedindo a operação adequada.
PAPER_JAM Um documento está bloqueado no alimentador de documentos.
FILM_TPA_READYV O adaptador de transparência está instalado e pronto para uso.
STORAGE_READYV O dispositivo de armazenamento interno está pronto.
STORAGE_FULLV O armazenamento está cheio, nenhuma operação de upload possível.
MULTIPLE_FEEDV Ocorreu uma condição de feed múltiplo (geralmente com um PAPER_JAM).
DEVICE_ATTENTIONV Há um erro que requer intervenção do usuário no dispositivo.
LAMP_ERRV O scanner não está pronto devido a um problema de lâmpada.

 
WIA_DPS_ENDORSER_CHARACTERS
ScannerDeviceEndorserCharacters

Contém todos os caracteres válidos que um aplicativo pode usar para criar cadeias de caracteres de endossador válidas. Um endossador é uma impressora instalada em um scanner que imprime uma mensagem de texto em cada página digitalizada. O minidriver deve validar a configuração da propriedade WIA_DPS_ENDORSER_STRING em relação ao conjunto de caracteres válido nesta propriedade. O minidriver cria e mantém essa propriedade.

Tipo: VT_BSTR, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE
WIA_DPS_ENDORSER_STRING
ScannerDeviceEndorserString

Contém uma cadeia de caracteres que deve ser endossada (em outras palavras, impressa) em cada página que o minidriver verifica. Um aplicativo define essa propriedade usando o conjunto de caracteres válido que é relatado na propriedade WIA_DPS_ENDORSER_CHARACTERS . O minidriver deverá endossar documentos somente se uma cadeia de caracteres estiver definida nesta propriedade. Uma cadeia de caracteres vazia significa que a funcionalidade do endossador está desabilitada.

Como é responsabilidade do driver interpretar a cadeia de caracteres do endossador, o driver pode usar caracteres especiais em WIA_DPS_ENDORSER_STRING. No entanto, apenas seus aplicativos entenderiam esses caracteres.

Tipo: VT_BSTR, Access: Leitura/Gravação, Valores válidos: WIA_PROP_NONE

Um driver que dá suporte à propriedade WIA_DPS_ENDORSER_STRING deve dar suporte à lista de tokens a seguir.

Token Descrição
$DATE$ A data no formulário YYYYY/MM/DD.
$DAY$ O dia no formato DD.
$MONTH$ O mês do ano no formato MM.
$PAGE_COUNT$ O número de páginas transferidas.
$TIME$ A hora do dia no formato HH:MM:SS.
$YEAR$ O ano no formato YYYYY.

 
WIA_DPS_FILTER_SELECT

Reservado, não use.

Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE
WIA_DPS_GLOBAL_IDENTITY
ScannerDeviceGlobalIdentity

Observação:
Essa propriedade tem suporte apenas no Windows Vista e posteriores.

 

Contém o endereço SOAP de um dispositivo de scanner de serviços Web. O mini driver WIA 2.0 cria e mantém essa propriedade.

Tipo: VT_BSTR, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE
WIA_DPS_HORIZONTAL_BED_REGISTRATION
ScannerDeviceHorizontalBedRegistration

Observação:
Não há suporte para essa propriedade com o Windows Vista e posteriores.

 

Contém o registro, ou alinhamento horizontal, para documentos colocados no flatbed. O minidriver cria e mantém essa propriedade.

Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE

A tabela a seguir tem as três constantes que são válidas com essa propriedade.

Constante Descrição
LEFT_JUSTIFIED O papel é deixado justificado.
CENTRADO O papel está centralizado.
RIGHT_JUSTIFIED O papel está certo justificado.

 

Consulte também

WIA_DPS_VERTICAL_BED_REGISTRATION
WIA_DPS_HORIZONTAL_BED_SIZE
ScannerDeviceHorizontalBedSize

Observação:
Não há suporte para essa propriedade com o Windows Vista e posteriores. Use WIA_IPS_MAX_HORIZONTAL_SIZE.

 

Especifica a largura máxima, em milésimos de polegada, que é verificada no eixo horizontal (X) a partir da placa de um scanner de flatbed na resolução atual. Essa propriedade também se aplica a alimentadores automáticos de documentos que movem planilhas para a placa de um scanner de flatbed para verificação. Essa propriedade é obrigatória para scanners que têm uma platen. Outros tipos de scanner implementarão a propriedade WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE .

Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE
WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceHorizontalSheetFeedSize

Observação:
Não há suporte para essa propriedade com o Windows Vista e posteriores. Use WIA_IPS_MAX_HORIZONTAL_SIZE.

 

Especifica a largura máxima, em milésimos de polegada, que é verificada no eixo horizontal (X) de um scanner de alimentação portátil ou de planilha na resolução atual. Essa propriedade também se aplica a alimentadores automáticos de documentos que verificam sem mover planilhas para a placa de um scanner de flatbed. Essa propriedade é obrigatória para scanners alimentados por planilhas, com rolagem e mão.

Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE
WIA_DPS_MAX_SCAN_TIME
ScannerDeviceMaxScanTime

Contém o tempo máximo para verificar uma única página com as configurações de propriedade atuais, em milissegundos. Um aplicativo lê essa propriedade para estimar o tempo necessário para examinar uma página. Isso é útil ao determinar as condições de um dispositivo que parou de responder. O minidriver cria e mantém essa propriedade. Essa propriedade é necessária para todos os scanners.

Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE
WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceMinHorizontalSheetFeedSize

Observação:
Não há suporte para essa propriedade com o Windows Vista e posteriores. Use WIA_IPS_MIN_HORIZONTAL_SIZE.

 

Contém as dimensões horizontais físicas da menor página que o alimentador de documentos do scanner pode examinar, em milésimos de polegada. O minidriver cria e mantém essa propriedade.

Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE

Consulte também

WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE
WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceMinVerticalSheetFeedSize

Observação:
Não há suporte para essa propriedade com o Windows Vista e posteriores. Use WIA_IPS_MIN_VERTICAL_SIZE.

 

Contém as dimensões verticais físicas da menor página que o alimentador de documentos do scanner pode examinar, em milésimos de polegada. O minidriver cria e mantém essa propriedade.

Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE

Consulte também

WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE
WIA_DPS_OPTICAL_XRES
ScannerDeviceOpticalXres

Observação:
Não há suporte para essa propriedade no Windows Vista. Use WIA_IPS_OPTICAL_XRES.

 

Resolução óptica horizontal. Maior resolução óptica horizontal com suporte no DPI. Essa propriedade é um único valor. Essa não é uma lista de todas as resoluções que podem ser geradas pelo dispositivo. Em vez disso, essa é a resolução da óptica do dispositivo. O minidriver cria e mantém essa propriedade. Essa propriedade é necessária para todos os scanners.

Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE
WIA_DPS_OPTICAL_YRES
ScannerDeviceOpticalYres

Observação:
Não há suporte para essa propriedade no Windows Vista. Use WIA_IPS_OPTICAL_YRES.

 

Resolução óptica vertical. Maior resolução óptica vertical com suporte no DPI. Essa propriedade é um único valor. Essa não é uma lista de todas as resoluções geradas pelo dispositivo. Em vez disso, essa é a resolução da óptica do dispositivo. O minidriver cria e mantém essa propriedade. Essa propriedade é necessária para todos os scanners.

Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE
WIA_DPS_ORIENTATION
ScannerDeviceOrientation

Contém a configuração de orientação atual. O minidriver cria e mantém essa propriedade.

Um aplicativo define a propriedade WIA_DPS_ORIENTATION para definir a orientação original de uma página ou imagem a ser adquirida. Para obter informações sobre como usar WIA_DPS_ORIENTATION, consulte WIA_DPS_PAGE_SIZE

Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST

A tabela a seguir tem as quatro constantes que são válidas com essa propriedade.

Valor Defination
PAISAGEM Rotação anti-horário de 90 graus, em relação à orientação PORTRAIT.
RETRATO 0 graus.
ROT180 Rotação anti-horário de 180 graus, em relação à orientação PORTRAIT.
ROT270 Rotação no sentido anti-horário de 270 graus, em relação à orientação PORTRAIT.

 

Consulte também

WIA_IPS_ROTATION
WIA_DPS_PAD_COLOR
ScannerDevicePadColor

Cor usada para armazenar quando não há dados de imagem suficientes para preencher um buffer solicitado. Essa propriedade é implementada para scanners que armazenam o buffer. Essa propriedade é opcional para todos os scanners. O minidriver cria e mantém essa propriedade.

Tipo: VT_UI1 | VT_VECTOR, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE

O formato das informações de cor é RGBQUAD.
WIA_DPS_PAGE_HEIGHT
ScannerDevicePageHeight

Observação:
Essa propriedade não tem suporte do Windows Vista. Use WIA_IPS_PAGE_HEIGHT.

 

Contém a altura, em milésimos de polegada, da página selecionada no momento. O minidriver cria e mantém a propriedade WIA_DPS_PAGE_HEIGHT . Um aplicativo lê essa propriedade para determinar as dimensões físicas da página que está sendo examinada. Se as configurações de extensão forem diferentes dos tamanhos de página conhecidos, essa propriedade relatará a altura da página cuja propriedade WIA_DPS_PAGE_SIZE é definida como WIA_PAGE_CUSTOM (que é um valor da propriedade WIA_DPS_PAGE_SIZE ). WIA_DPS_PAGE_HEIGHT deve estar sincronizado com WIA_IPS_XEXTENT, que relata a altura, em pixels, da página a ser verificada.

Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE
WIA_DPS_PAGE_SIZE
ScannerDevicePageSize

Observação:
Essa propriedade não tem suporte do Windows Vista. Use WIA_IPS_PAGE_SIZE.

 

Contém o tamanho da página que está selecionada para ser examinada no momento. Para selecionar as dimensões da página a ser digitalizada, um aplicativo define essa propriedade. O minidriver cria e mantém essa propriedade.

Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST

A tabela a seguir tem as três constantes que são válidas com essa propriedade.

Valor Definição
WIA_PAGE_A4 8267 X 11692 (orientação PORTRAIT)
WIA_PAGE_CUSTOM Definido pelos valores das propriedades WIA_DPS_PAGE_HEIGHT e WIA_DPS_PAGE_WIDTH
WIA_PAGE_LETTER 8500 X 11000 (orientação PORTRAIT)

 

O valor da propriedade WIA_IPS_ORIENTATION determina a orientação da página selecionada no momento. As propriedades WIA_DPS_PAGE_WIDTH e WIA_DPS_PAGE_HEIGHT relatam as dimensões da página, em milésimos de polegada. Observe que essas propriedades devem estar de acordo com WIA_IPS_XEXTENT e WIA_IPS_YEXTENT, que contêm as dimensões da página em pixels. Os valores válidos do tipo WIA_PROP_LIST devem depender das configurações válidas da propriedade WIA_IPS_ORIENTATION . Se o dispositivo não puder verificar documentos orientados à paisagem com uma configuração de WIA_PAGE_A4, WIA_PAGE_A4 não deverá aparecer na lista de valores válidos para a propriedade WIA_DPS_PAGE_SIZE quando WIA_IPS_ORIENTATION estiver definido como LANSCAPE.

Se um aplicativo definir WIA_DPS_PAGE_SIZE para qualquer valor diferente de WIA_PAGE_CUSTOM, o minidriver deverá ajustar os valores de WIA_DPS_PAGE_WIDTH e WIA_DPS_PAGE_HEIGHT às dimensões da página em milésimos de polegada. Ele também deve ajustar os valores de WIA_IPS_XEXTENT e WIA_IPS_YEXTENT para as dimensões da página em pixels.

Se uma configuração de extensão (WIA_IPS_XEXTENT ou WIA_IPS_YEXTENT) for alterada para um valor que não corresponda à configuração de tamanho de página atual, o minidriver deverá alterar o valor da propriedade WIA_DPS_PAGE_SIZE para WIA_PAGE_CUSTOM. O minidriver também deve modificar WIA_DPS_PAGE_WIDTH ou WIA_DPS_PAGE_HEIGHT de acordo com a configuração de nova extensão.

Se WIA_IPS_ORIENTATION estiver definido como LANSCAPE, as configurações de extensão serão "invertidas". Por exemplo, se um aplicativo definir WIA_DPS_PAGE_SIZE como WIA_PAGE_A4, o minidriver deverá definir WIA_DPS_PAGE_WIDTH como 11692 e WIA_DPS_PAGE_HEIGHT como 8267. (O minidriver também deve definir WIA_IPS_XEXTENT e WIA_IPS_YEXTENT adequadamente.) Observe que, se WIA_DPS_PAGE_SIZE for definido como WIA_PAGE_CUSTOM, a configuração de orientação não será usada para determinar as dimensões de extensão da página a serem verificadas.

O minidriver é responsável por garantir que a propriedade WIA_IPS_ORIENTATION esteja de acordo com a área de seleção atual. Se um aplicativo alterar o valor de WIA_IPS_ORIENTATION para um que seja inválido para o tamanho da página selecionado no momento, o minidriver deverá alterar o valor de WIA_DPS_PAGE_SIZE para um tamanho de página compatível com o novo valor de orientação.

Se um aplicativo definir a propriedade WIA_DPS_PAGE_SIZE como WIA_PAGE_CUSTOM, a área de seleção atual não será afetada. O minidriver WIA deve obter o layout da imagem atual, começando pelas configurações atuais das propriedades WIA_IPS_XPOS e WIA_IPS_YPOS . Se a configuração de tamanho de página resultar em uma área de seleção fora da cama do verificador, o minidriver deverá ajustar automaticamente os valores do WIA_IPS_XPOS e WIA_IPS_YPOS propriedades para configurações válidas. Se as propriedades WIA_DPS_PAGE_SIZE e WIA_IPS_ORIENTATION forem definidas ao mesmo tempo e forem inválidas quando aplicadas em combinação, o minidriver deverá falhar nas configurações do aplicativo retornando um erro no IWiaMiniDrv::d rvValidateItemProperties. .

Os quatro exemplos a seguir mostram diferentes cenários de WIA_DPS_PAGE_SIZE .

  1. O driver relata as configurações.
  2. Um aplicativo define a propriedade WIA_DPS_PAGE_SIZE como WIA_PAGE_LETTER.
  3. Um aplicativo define a propriedade WIA_IPS_ORIENTATION como LANSCAPE.
  4. Um aplicativo altera a propriedade WIA_IPS_XEXTENT para um valor menor.

Exemplo 1: o minidriver relata as configurações

No exemplo a seguir, o minidriver define uma área de seleção personalizada antes que um aplicativo defina as propriedades wia. Nesse caso, a área de seleção representa todo o flatbed.

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_WIDTH = 11500
WIA_DPS_PAGE_HEIGHT = 14000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1150
WIA_IPS_YEXTENT = 1400
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Exemplo 2: um aplicativo define a propriedade WIA_DPS_PAGE_SIZEcomo WIA_PAGE_LETTER

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_WIDTH = 8500
WIA_DPS_PAGE_HEIGHT = 11000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 850
WIA_IPS_YEXTENT = 1100
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Exemplo 3: um aplicativo define a propriedade WIA_IPS_ORIENTATIONcomo LANSCAPE

A cama física deve ser capaz de adquirir uma página que estava originalmente na orientação paisagem.

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_HEIGHT = 11000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1100
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Exemplo 4: um aplicativo altera a propriedade WIA_IPS_XEXTENTpara um valor menor

No exemplo a seguir, um aplicativo altera a propriedade WIA_IPS_XEXTENT para 1000. O minidriver deve assumir que o novo valor contido em WIA_IPS_XEXTENT não é mais válido para a propriedade WIA_DPS_PAGE_SIZE e, portanto, deve alterar WIA_DPS_PAGE_SIZE para WIA_PAGE_CUSTOM. O minidriver também deve ajustar WIA_DPS_PAGE_WIDTH.

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_HEIGHT = 10000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1000
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100
WIA_DPS_PAGE_WIDTH
ScannerDevicePageWidth

Observação:
Essa propriedade não tem suporte do Windows Vista. Use WIA_IPS_PAGE_WIDTH.

 

Contém a largura da página atual selecionada, em milésimos de polegada. Um aplicativo lê essa propriedade para determinar as dimensões físicas da página que está sendo examinada. Se as configurações de extensão forem diferentes dos tamanhos de página conhecidos, essa propriedade relatará a largura da página cuja propriedade WIA_DPS_PAGE_SIZE é definida como WIA_PAGE_CUSTOM. WIA_DPS_PAGE_WIDTH deve estar sincronizado com o valor de WIA_IPS_XEXTENT, que relata a largura, em pixels, da página a ser verificada. O minidriver cria e mantém essa propriedade.

Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE
WIA_DPS_PAGES
ScannerDevicePages

Observação:
Essa propriedade não tem suporte do Windows Vista. Use WIA_IPS_PAGES.

 

Contém o número atual de páginas a serem adquiridas de um alimentador de documentos automático. O minidriver cria e mantém essa propriedade.

Tipo: VT_I4; Acesso: leitura/gravação; Valores válidos: WIA_PROP_RANGE (zero até o número máximo de páginas que o alimentador de documentos pode armazenar)

Um aplicativo lê essa propriedade para determinar a capacidade da página do alimentador de documentos. O aplicativo também define essa propriedade como o número de páginas que ele vai verificar.

Observação:
Se o modo duplex estiver habilitado (WIA_DPS_DOCUMENT_HANDLING_SELECT será definido como FEEDER | DUPLEX ), WIA_DPS_PAGES ainda é igual ao número de páginas a serem digitalizadas.

 

Uma folha de papel conterá automaticamente duas páginas se DUPLEX estiver habilitado, mesmo que o lado traseiro da página esteja em branco.

Definir WIA_DPS_PAGES como 1 faz com que um scanner processe um dos lados da página. É recomendável que, se um scanner não conseguir verificar apenas um lado de uma página enquanto estiver no modo duplex, o valor WIA_DPS_PAGES válido para o membro Inc da estrutura WIA_PROPERTY_INFO deverá ser alterado para 2. Esse valor sinaliza ao aplicativo que ele deve solicitar páginas em múltiplos de dois. Um valor igual a zero significa que todas as páginas carregadas no feeder de documentos devem ser examinadas.
WIA_DPS_PLATEN_COLOR
ScannerDevicePlatenColor

Especifica a cor do platen na parte de trás da planilha a ser verificada. Essa propriedade é opcional para scanners que têm uma platen. O minidriver cria e mantém essa propriedade.

Tipo: VT_UI1 | VT_VECTOR, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE

O formato das informações de cor é RGBQUAD.
WIA_DPS_PREVIEW
ScannerDevicePreview

Observação:
Essa propriedade não tem suporte do Windows Vista. Use WIA_IPS_PREVIEW.

 

Indica o modo de visualização de um dispositivo. Um aplicativo define essa propriedade para colocar o dispositivo em um modo de visualização.

Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST

A tabela a seguir tem as duas constantes que são válidas com essa propriedade.

Valor Definição
WIA_FINAL_SCAN O aplicativo executará uma verificação final.
WIA_PREVIEW_SCAN O aplicativo executará uma verificação de visualização.

 
WIA_DPS_SCAN_AHEAD_PAGES
ScannerDeviceScanAheadPages

Contém um valor que indica se o verificador armazenará em cache páginas em um buffer de scanner antes de enviá-las para o aplicativo.

Um valor zero desabilita a verificação antecipadamente e nenhuma página será examinada antecipadamente. Fazer transferências de dados normais no item de verificação antecipada em buffer recupera as páginas armazenadas em buffer. As propriedades wia não podem ser alteradas durante uma operação de verificação antecipada. Essa propriedade é opcional.

Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_RANGE de zero ao número máximo de páginas que o alimentador de documentos pode conter.
WIA_DPS_SCAN_AVAILABLE_ITEM
ScannerDeviceScanAvailableItem

Observação:
Essa propriedade tem suporte apenas pelo Windows 7 e posteriores.

 

Indica a origem de entrada (flatbed, alimentador automático de documentos ou adaptador de verificação de fil) a ser verificado ou o local de armazenamento do qual transferir dados.

Um evento de verificação notifica o aplicativo de que o usuário iniciou uma verificação, mas o evento não fornece o nome do item WIA que representa a fonte de entrada. O manipulador de eventos do aplicativo pode consultar a propriedade WIA_DPS_SCAN_AVAILABLE_ITEM do item raiz para obter o nome do item de origem de entrada.

Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_RANGE de zero ao número máximo de páginas que o alimentador de documentos pode conter.
WIA_DPS_SERVICE_ID
ScannerDeviceServiceId

Observação:
Essa propriedade tem suporte apenas pelo Windows Vista e posteriores.

 

Contém a ID de serviço de um dispositivo de scanner dos Serviços Web. O mini driver WIA 2.0 cria e mantém essa propriedade.

Tipo: VT_BSTR, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE
WIA_DPS_SHEET_FEEDER_REGISTRATION
ScannerDeviceSheetFeederRegistration

Observação:
Não há suporte para essa propriedade com o Windows Vista e posteriores. Use WIA_IPS_SHEET_FEEDER_REGISTRATION.

 

Contém o registro, ou alinhamento e detecção de borda, para documentos que são colocados no flatbed. O minidriver cria e mantém essa propriedade. Essa propriedade indica como a planilha é posicionada horizontalmente na cabeça de verificação de um scanner portátil ou alimentado por planilhas. A propriedade é usada para prever onde no cabeçalho da verificação um documento é colocado.

Para scanners que dão suporte a mais de uma cabeça de verificação, essa propriedade é relativa à cabeça de verificação mais alta. Essa propriedade é obrigatória para scanners alimentados por planilhas, com rolagem e portáteis.

Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE

A tabela a seguir tem as três constantes que são válidas com essa propriedade.

Constante Descrição
LEFT_JUSTIFIED A planilha é posicionada à esquerda em relação à cabeça de verificação.
CENTRADO A planilha é centralizada na cabeça de verificação.
RIGHT_JUSTIFIED A planilha está posicionada à direita em relação à cabeça de verificação.

 
WIA_DPS_SHOW_PREVIEW_CONTROL
ScannerDeviceShowPreviewControl

Observação:
Essa propriedade não tem suporte do Windows Vista. Use WIA_IPS_SHOW_PREVIEW_CONTROL.

 

Indica se um item precisa de um controle de visualização exibido para o usuário. O minidriver cria e mantém essa propriedade.

Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE

A tabela a seguir tem as duas constantes que são válidas com essa propriedade.

Constante Descrição
WIA_SHOW_PREVIEW_CONTROL Mostre um controle de visualização para o usuário, pois esse dispositivo pode executar uma versão prévia.
WIA_DONT_SHOW_PREVIEW_CONTROL Não mostre um controle de visualização para o usuário, pois esse dispositivo não pode executar uma versão prévia.

 
WIA_DPS_USER_NAME
ScannerDeviceUserName

Observação:
Essa propriedade tem suporte apenas pelo Windows Vista e posteriores.

 

Usado pelo serviço WIA para informar o mini driver sobre o nome da conta de usuário (incluindo o nome de domínio de rede quando aplicável) da sessão na qual o aplicativo WIA atual está em execução.

Essa é uma propriedade de item raiz, gerenciada pelo serviço WIA.

Tipo: VT_BSTR, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE
WIA_DPS_VERTICAL_BED_REGISTRATION
ScannerDeviceVerticalBedRegistration

Observação:
Não há suporte para essa propriedade com o Windows Vista e posteriores.

 

Contém o registro, ou alinhamento vertical e detecção de borda, para documentos colocados no flatbed. O minidriver cria e mantém essa propriedade.

Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE

A tabela a seguir tem as três constantes que são válidas com essa propriedade..

Constante Descrição
TOP_JUSTIFIED O papel é mais justificado.
CENTRADO O papel é centralizado.
BOTTOM_JUSTIFIED O papel é justificado por baixo.

 

Confira também.

WIA_DPS_HORIZONTAL_BED_REGISTRATION
WIA_DPS_VERTICAL_BED_SIZE
ScannerDeviceVerticalBedSize

Observação:
Não há suporte para essa propriedade com o Windows Vista e posteriores. Use WIA_IPS_MAX_VERTICAL_SIZE.

 

Especifica a altura máxima, em milésimos de polegada, que é verificada no eixo vertical (Y) a partir do platen de um scanner de flatbed na resolução atual. Essa propriedade também se aplica a alimentadores automáticos de documentos, que movem planilhas para a placa de um scanner de flatbed para verificação. Essa propriedade é obrigatória para scanners que têm uma platen. Em vez disso, outros tipos de scanner implementarão a propriedade WIA_DPS_VERTICAL_SHEET_FEED_SIZE .

Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE
WIA_DPS_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceVerticalSheetFeedSize

Observação:
Não há suporte para essa propriedade com o Windows Vista e posteriores. Use WIA_IPS_MAX_VERTICAL_SIZE.

 

Especifica a altura máxima, em milésimos de polegada, que é verificada no eixo vertical (Y) de um scanner de alimentação de folha ou portátil na resolução atual. Essa propriedade também se aplica a alimentadores automáticos de documentos que verificam sem mover planilhas para a placa de um scanner de flatbed. Essa propriedade é obrigatória para scanners alimentados por planilhas. Scanners alimentados por rolagem e mão não devem implementar essa propriedade.

Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2003 [somente aplicativos da área de trabalho]
parâmetro
Wiadef.h