Constantes comuns de propriedade de item WIA
As seguintes constantes de propriedade do dispositivo devem ter suporte em todas as interfaces IWiaItem, IWiaItem2 e IWiaDrvItem Interface , a menos que indicado de outra forma em suas descrições.
O prefixo "WIA_IPA_" indica uma propriedade de item para todos os dispositivos e é a convenção de nomenclatura usada em C/C++. Para fins de script, essas constantes usam o prefixo "Picture" 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 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Esse sinalizador controla o acesso ao item, bem como se o item foi excluído. Necessário para todos os itens do WIA 2.0. Tipo: VT_I4; Leitura/gravação ou somente leitura, dependendo da capacidade do item de ter seus direitos de acesso alterados; Valores válidos: WIA_PROP_FLAG A tabela a seguir tem os cinco sinalizadores válidos com essa propriedade.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Essa propriedade é reservada por para uso futuro e não é implementada no momento. Tipo: VT_I4, Access: Somente Leitura, Valores Válidos: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contém o número de bits por canal para a imagem. O minidriver cria e mantém essa propriedade. Necessário para todos os itens de imagem armazenados ou habilitados para aquisição do WIA 2.0. Tipo: VT_I4, Access: Somente Leitura, Valores Válidos: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contém o tamanho do buffer, em bytes, usado durante uma transferência de dados. O minidriver cria e mantém essa propriedade. Um aplicativo pode ler essa propriedade para determinar o tamanho do buffer especificado pelo driver para transferências de dados. O serviço WIA também lê essa propriedade para alocar memória para o minidriver durante a transferência de dados Opcional para todos os itens wia 2.0 habilitados para transferência. Tipo: VT_I4, Access: Somente Leitura, Valores Válidos: WIA_PROP_NONE
Observação: |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contém o número de bytes em uma linha de verificação da imagem. O minidriver cria e mantém essa propriedade. Opcional para todos os itens do WIA 2.0. Tipo: VT_I4, Access: Somente Leitura, Valores Válidos: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contém o número de canais por pixel para a imagem. O minidriver cria e mantém essa propriedade. Necessário para todos os itens de imagem armazenados ou habilitados para aquisição do WIA 2.0. Tipo: VT_I4, Access: Somente Leitura, Valores Válidos: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Essa propriedade é reservada por para uso futuro e não é implementada no momento. Tipo: VT_I4, Access: Somente Leitura, Valores Válidos: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contém o tipo de compactação atual usado. O minidriver cria e mantém essa propriedade. Um aplicativo lê essa propriedade para determinar o tipo de compactação de imagem ou define essa propriedade para definir a configuração de compactação. Tipo: VT_I4, Acesso: Leitura/Gravação, Valores Válidos: WIA_PROP_LIST A tabela a seguir tem as constantes que são válidas com essa propriedade. O símbolo V indica que a constante tem suporte apenas no Windows Vista e posterior. (Ele só está disponível por meio da interface IWiaItem2 .)
[!Observação] Quando essa propriedade é WIA_COMPRESSION_NONE e WIA_IPA_FORMAT é WiaImgFmt_PDFA ou WiaImgFmt_XPS; em seguida, WIA_COMPRESSION_NONE significa que o modo de compactação é indefinido e o verificador deve decidir sobre um modo. WIA_COMPRESSION_AUTO é um novo valor de propriedade definido para a propriedade WIA_IPA_COMPRESSION. Esse valor é válido para todos os itens de fonte de dados de imagem programáveis, incluindo Flatbed e Feeder. Quando esse valor é compatível com o minigerenciador WIA, o cliente do aplicativo WIA pode definir WIA_IPA_COMPRESSION para habilitar a detecção automática do modo de compactação no dispositivo. WIA_COMPRESSION_AUTO pode trabalhar com e sem suporte para cor automática completa ou habilitado (WIA_DATA_AUTO e WIA_DEPTH_AUTO). WIA_COMPRESSION_AUTO é mais útil com formatos de arquivo de transferência que dão suporte a vários tipos de dados e profundidades de bits, como WiaImgFmt_RAW. Para obter mais informações sobre formatos de arquivo de transferência, consulte WIA_IPA_FORMAT nesta tabela. É opitonal para o mini driver wia suport WIA_COMPRESSION_AUTO. Quando há suporte, o mini driver WIA nunca deve defini-lo como o valor padrão para WIA_IPA_COMPRESSION; somente o aplicativo WIA pode definir esse valor. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contém a configuração de tipo de dados atual para o dispositivo. O minidriver cria e mantém essa propriedade. Um aplicativo lê essa propriedade para determinar o tipo de dados da imagem. Um aplicativo grava essa propriedade para definir o tipo de dados atual da imagem prestes a ser transferida. Essa propriedade é necessária para todos os itens do WIA 2.0. Deve ser Leitura/Gravação para todos os itens habilitados para aquisição do WIA 2.0 e Somente Leitura para itens de armazenamento WIA 2.0. Tipo: VT_I4; Acesso para sistemas operacionais pré-Windows Vista: essa propriedade é Somente Leitura para câmeras e Leitura/Gravação para scanners; Acesso para Windows Vista e posterior: esta propriedade é Somente Leitura para itens de WIA_CATEGORY_FOLDER e WIA_CATEGORY_FINISHED_FILE e Leitura/Gravação para todas as outras categorias de itens wia 2.0; Valores válidos: WIA_PROP_LIST A tabela a seguir tem as seis constantes que são válidas com quando WIA_IPA_FORMAT não está definido como WiaImgFmt_RAW.
A propriedade WIA_IPA_DATATYPE também é usada para descrever o tipo de transferência de dados RAW a ser usada quando o aplicativo define WiaImgFmt_RAW. O driver deve definir a propriedade WIA_IPA_DATATYPE como uma lista de valores permitidos dos quais o aplicativo pode escolher um. Se o dispositivo puder ser definido como apenas um único valor, crie um tipo de WIA_PROP_LIST e coloque o valor válido nele. Verifique a propriedade WIA_IPA_DEPTH para determinar a profundidade do bit. Essa propriedade geralmente contém um único valor para câmeras. A tabela a seguir lista as constantes que são válidas com WIA_IPA_DATATYPE quando WIA_IPA_FORMAT é definido como WiaImgFmt_RAW.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
WIA_IPA_DEPTH Contém a configuração de profundidade de bit de uma imagem. O minidriver cria e mantém essa propriedade. Um aplicativo lê essa propriedade para determinar a configuração de profundidade de bit da imagem. O aplicativo também pode ser capaz de definir esse valor para a profundidade de bit desejada. Se o dispositivo puder ser definido como apenas um único valor, crie um tipo de WIA_PROP_LIST e coloque o valor válido nele. Essa propriedade é necessária para todos os itens do WIA 2.0. Deve ser Leitura/Gravação para todos os itens habilitados para aquisição do WIA 2.0 e Somente Leitura para itens de armazenamento WIA 2.0. Tipo: VT_I4; Acesso para sistemas operacionais pré-Windows Vista: Leitura/Gravação; Acesso para Windows Vista e posterior: esta propriedade é Somente Leitura para itens de WIA_CATEGORY_FOLDER e WIA_CATEGORY_FINISHED_FILE e Leitura/Gravação para todas as outras categorias de itens wia 2.0; Valores válidos: WIA_PROP_LIST WIA_DEPTH_AUTO é definido como 0 bits por pixel e é um novo valor de propriedade definido para o WIA_IPA_DEPTH. Esse valor é válido para todos os itens de fonte de dados de imagem programáveis, incluindo Flatbed e Feeder. Quando WIA_DEPTH_AUTO é compatível com o mini driver WIA, o cliente de aplicativo WIA pode definir WIA_IPA_DEPTH para esse valor, para habilitar a detecção automática de cores no dispositivo. Quando WIA_DEPTH_AUTO estiver definido, o mini driver WIA deverá atualizar WIA_IPA_DATATYPE no mesmo item para WIA_DATA_AUTO (que deve ser um valor com suporte, se o dispositivo der suporte à cor automática). WIA_DEPTH_AUTO é um valor opcional, mas torna-se necessário quando WIA_DATA_AUTO tem suporte para WIA_IPA_DATATYPE. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contém a extensão de nome de arquivo para um formato de arquivo específico. O minidriver cria e mantém essa propriedade. Opcional para todos os itens wia 2.0 habilitados para transferência. Tipo: VT_BSTR, Access: Somente Leitura, Valores Válidos: WIA_PROP_NONE O driver atualiza essa propriedade para refletir o valor atual da propriedade WIA_IPA_FORMAT . Por exemplo, se WIA_IPA_FORMAT for WiaImgFmt_JPEG, WIA_IPA_FILENAME_EXTENSION deverá ser jpg. Se WIA_IPA_FORMAT for WiaImgFmt_BMP, WIA_IPA_FILENAME_EXTENSION deverá ser BMP.
Observação: Essa propriedade é recomendada para drivers que dão suporte a formatos padrão e são necessários para drivers que implementam formatos personalizados. Ele informa o aplicativo da extensão de nome de arquivo correta a ser usada durante a transferência de arquivos formatados de forma privada. Por exemplo, se a A. Datum Corporation criou um driver WIA que transferiu um arquivo em um novo formato, a empresa poderá especificar uma extensão de "adc". Isso permite que os aplicativos transfiram dados nesse formato para um arquivo e criem um nome de arquivo como myfile.adc, o que é útil para outras pessoas que entendem a nova extensão. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contém o formato atual da imagem prestes a ser transferida. Um aplicativo lê essa propriedade para determinar o formato da imagem que ela está prestes a receber. Um aplicativo grava essa propriedade para definir o formato. Essa propriedade depende da propriedade WIA_IPA_TYMED . O minidriver cria e mantém essa propriedade. Se o dispositivo puder ser definido como apenas um único valor, crie um tipo de WIA_PROP_LIST e coloque o valor válido nele. Tipo: CLSID, Access: Leitura/Gravação, Valores Válidos: WIA_PROP_LIST A tabela a seguir lista as constantes que são válidas com essa propriedade. O asterisco * indica que a constante não tem suporte no Windows Vista. (Ele só está disponível por meio da interface IWiaItem .) O asterisco duplo ** indica que a constante não tem suporte no Windows Server 2003 ou no Windows Vista. O símbolo V indica que a constante tem suporte apenas no Windows Vista e posterior. (Ele só está disponível por meio da interface IWiaItem2 .)
Observação: |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contém o nome completo do item (o nome do item junto com informações de caminho). O nome do item completo é o mesmo que o parâmetro bstrFullItemName da função do utilitário de serviço wiasCreateDrvItem . Um aplicativo lê essa propriedade para determinar qual item ele está usando no momento e onde esse item está localizado na árvore de itens. Cada item deve ter um nome exclusivo. Os aplicativos geralmente usam o nome completo do item para pesquisar itens na árvore de itens. O serviço WIA cria e mantém essa propriedade. Necessário para todos os itens do WIA 2.0. Tipo: VT_BSTR, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Essa propriedade é reservada para uso futuro e não é implementada no momento. Tipo: VT_I4, Acesso: Somente Leitura, Valores Válidos: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contém o nome do perfil ICM necessário para decodificar corretamente a imagem. Um aplicativo lê essa propriedade para determinar o perfil ICM a ser usado ao processar a imagem. O serviço WIA cria e mantém essa propriedade com base na entrada ICMProfiles no arquivo de instalação do driver. Tipo: VT_BSTR, Access: Somente Leitura, Valores Válidos: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Com suporte apenas no Windows Vista e posteriores. Os itens wia 2.0 são agrupados em categorias que definem como um IWiaItem2 deve ser tratado ou usado. Por exemplo, se o item representa um alimentador, o aplicativo deve esperar que ele contenha as propriedades necessárias do alimentador de documentos e opere como um alimentador de documentos. Se o item representar um arquivo concluído, um aplicativo WIA 2.0 deverá tratá-lo dessa forma, supondo que os dados estejam estáticos e localizados no dispositivo. (As regras para cada item serão definidas em seus documentos de especificação individuais.) Necessário para todos os itens do WIA 2.0. Tipo: VT_CLSID, Access: Somente Leitura, Valores válidos: GUIDs de categoria de item |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contém os sinalizadores descritivos para um item WIA. Os sinalizadores de item são iguais aos do parâmetro lObjectFlags da função do utilitário de serviço wiasCreateDrvItem . O serviço WIA cria e mantém essa propriedade. Um aplicativo lê essa propriedade para determinar os valores de sinalizador descritivo do item. Tipo: acesso VT_I4 : somente leitura, valores válidos: WIA_PROP_NONE A tabela a seguir tem os sinalizadores válidos com essa propriedade. Um asterisco * indica que o sinalizador não tem suporte no Windows Vista ou posterior. (Ele só está disponível por meio da interface IWiaItem .) Um asterisco duplo ** indica que o sinalizador não tem suporte no Windows Server 2003 ou no Windows Vista ou posterior. O símbolo V indica que o sinalizador tem suporte apenas no Windows Vista e posterior. (Ele só está disponível por meio da interface IWiaItem2 .)
Alguns desses sinalizadores são necessários ou opcionais para itens wia 2.0, de acordo com a categoria do item, conforme mostrado nesta tabela.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contém o nome do item. Um aplicativo lê essa propriedade para determinar qual item ele está usando no momento. Cada item tem um nome exclusivo. O serviço WIA cria e mantém essa propriedade. Necessário para todos os itens do WIA 2.0. Tipo: VT_BSTR, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contém o tamanho atual, em bytes, dos dados associados ao item. O minidriver cria e mantém essa propriedade. Contains é o tamanho total dos dados que estão sendo transferidos. Se esse valor for zero, isso significa que o minidriver não tem informações sobre o tamanho exato dos dados. (Isso é comum para dados compactados.) Um aplicativo lê esse valor para determinar o tamanho da aquisição antes de ocorrer. O serviço WIA lê essa propriedade para ajudar a alocar memória para transferências de dados. Para obter mais informações, consulte Transferindo dados para um aplicativo WIA se a propriedade estiver definida como zero e TYMED estiver configurado para uma transferência de arquivo, o serviço WIA não alocará memória para o minidriver WIA. Necessário para todos os itens wia 2.0 habilitados para transferência. Tipo: VT_I4, Acesso: Somente Leitura, Valores Válidos: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contém a hora em que a imagem foi originalmente capturada. O minidriver cria e mantém essa propriedade. Essa propriedade deve ser relatada como um vetor de oito valores WORD na forma de uma estrutura SYSTEMTIME (descrita na documentação do SDK da Plataforma). Opcional para todos os itens do WIA 2.0. Tipo: VT_UI2 | acesso VT_VECTOR : somente leitura/gravação ou leitura, valores válidos: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Com suporte apenas no Windows Vista e posteriores. Especifica quantos itens são armazenados no item WIA_CATEGORY_FOLDER. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Especifica o tamanho mínimo do buffer usado em transferências de dados. Se a transferência de dados for executada por meio de um mecanismo de retorno de chamada, o valor da propriedade poderá ser tão pequeno quanto 64 KB. No entanto, se a transferência for para arquivo, o valor da propriedade será o número de bytes necessários para transferir uma página de dados de cada vez. O minidriver cria e mantém essa propriedade WIA. Opcional para todos os itens wia 2.0 habilitados para transferência. Tipo: VT_I4, Acesso: Somente Leitura, Valores Válidos: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contém o número de linhas contidas na imagem (a altura vertical da imagem em pixels). O minidriver cria e mantém essa propriedade. Opcional para todos os itens do WIA 2.0. Tipo: VT_I4, Acesso: Somente Leitura, Valores Válidos: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contém o número de pixels em cada linha da imagem (a largura da imagem em pixels). O minidriver cria e mantém essa propriedade. Opcional para todos os itens do WIA 2.0. Tipo: VT_I4, Acesso: Somente Leitura, Valores Válidos: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Não há suporte para essa propriedade no Windows Vista e posteriores. Contém opções de empacotamento de dados de imagem. O minidriver cria e mantém essa propriedade. Um aplicativo lê essa propriedade para determinar as opções de empacotamento de imagem ou define as opções atuais de empacotamento de imagem. Tipo: VT_I4; Acesso: leitura/gravação; Valores válidos: WIA_PROP_LIST. Se o dispositivo puder ser definido como apenas um único valor, crie um tipo de WIA_PROP_LIST e coloque o valor válido nele. A tabela a seguir tem as duas constantes que são válidas com essa propriedade.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contém o formato preferencial para imagens que este minidriver transfere. O minidriver cria e mantém essa propriedade. Necessário para todos os itens wia 2.0 habilitados para transferência. Tipo: CLSID, Access: Somente leitura, valores válidos: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Especifica um CLSID que representa um conjunto de valores de propriedade do dispositivo. Se um driver de dispositivo implementar esse recurso, os aplicativos usarão essa propriedade para determinar se o dispositivo dá suporte a um conjunto de valores. Tipo: CLSID, Access: Somente leitura, valores válidos: WIA_PROP_LIST A tabela a seguir tem as 12 constantes que são válidas com essa propriedade.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Com suporte apenas no Windows Vista e posteriores. Contém o número de bits em cada canal. Essa propriedade deve ser relatada como um vetor de quantos valores BYTE houver canais, em que o primeiro BYTE corresponde ao número de bits no primeiro canal, o segundo byte ao número de bits no segundo canal e assim por diante. Precisa haver tantas entradas quanto canais de acordo com WIA_IPA_CHANNELS_PER_PIXEL. O driver define essa propriedade quando o aplicativo alterna para WiaImgFmt_RAW. Para os subtipos conhecidos, há tantas entradas quanto listadas na tabela em WIA_IPA_RAW_SUBTYPE. Tipo: VT_UI1|VT_VECTOR, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Essa propriedade é reservada por para uso futuro e não é implementada no momento. Tipo: VT_I4, Acesso: Somente Leitura, Valores Válidos: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Especifica se as páginas de propriedades gerais devem ser suprimidas para itens no dispositivo. Essa propriedade está disponível no Windows XP e posterior. Tipo: VT_I4, Acesso: Somente Leitura, Valores Válidos: WIA_PROP_NONE A tabela a seguir tem as constantes que são válidas com essa propriedade. O asterisco * indica que a constante não é válida com o Windows Vista e posteriores. (Ele só está disponível por meio da interface IWiaItem .)
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Essa propriedade contém a configuração do método de transferência. O minidriver cria e mantém essa propriedade. Um aplicativo lê essa propriedade para determinar o método de transferência de dados do minidriver. Necessário para todos os itens wia 2.0 habilitados para transferência. Tipo: VT_I4, Access: Leitura/Gravação, Valores Válidos: WIA_PROP_LIST A tabela a seguir tem as constantes que são válidas com essa propriedade. O asterisco * indica constantes que não são válidas com o Windows Vista e posteriores. (Eles só estão disponíveis por meio da interface IWiaItem .)
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Com suporte apenas no Windows Vista e posteriores. Especifica o número de bytes a serem carregados para um item. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_NONE |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2008 [somente aplicativos da área de trabalho] |
| parâmetro |
|