Biblioteca de serviços de driver wia

A biblioteca de serviços de driver wia contém funções que um minidriver WIA pode chamar para obter assistência na execução das seguintes tarefas:

• Criar e manter uma árvore de itens

• Registrar mensagens de erro e rastreamento

• Ler e armazenar propriedades de item

• Atualizar e transferir dados

Um minidriver WIA chama a maioria dessas funções de seus métodos de Interface IWiaMiniDrv conforme necessário. Cada minidriver WIA, no entanto, deve chamar a função wiasCreateDrvItem no método IWiaMiniDrv::d rvInitializeWia para criar itens de driver. Cada chamada bem-sucedida para uma função wiasCreateDrvItem cria um objeto de item IWiaDrvItem , que é usado na árvore de itens do minidriver. Vários métodos da Interface IWiaDrvItem têm um parâmetro do tipo IWiaDrvItem, incluindo IWiaDrvItem::AddItemToFolder, IWiaDrvItem::GetFirstChildItem, IWiaDrvItem::GetNextSiblingItem e IWiaDrvItem::GetParentItem. Além disso, a função wiasGetDrvItem tem um parâmetro desse tipo.

A biblioteca de serviços de driver fornece as seguintes funções.

Criar e manter uma árvore de itens

Função	Descrição
wiasCreateChildAppItem	Cria um novo item de aplicativo e o insere como um filho do item (pai) especificado.
wiasCreateDrvItem	Cria um objeto IWiaDrvItem .
wiasGetChildrenContexts	Recupera uma matriz de contextos de item pertencentes aos filhos do item atual.
wiasGetContextFromName	Recupera o contexto do item para um nome de item.
wiasGetDrvItem	Recupera um item de driver.
wiasGetRootItem	Recupera o contexto de item raiz de um item WIA especificado.

Registrar mensagens de erro e rastreamento

Função	Descrição
wiasCreateLogInstance	Cria uma instância de um objeto de registro em log.
wiasDebugError	Imprime uma cadeia de caracteres de erro de depuração no console de depuração Gerenciador de Dispositivos. A cor de saída é sempre vermelha. Essa função é fornecida apenas para compatibilidade. Em vez disso, é recomendável usar WIAS_ERROR .
wiasDebugTrace	Imprime uma cadeia de caracteres de rastreamento de depuração no console de depuração Gerenciador de Dispositivos. Essa função é fornecida apenas para compatibilidade. Em vez disso, é recomendável usar WIA_TRACE .
wiasFormatArgs	Formata uma lista de argumentos em uma cadeia de caracteres empacotada para registro em log.
wiasPrintDebugHResult	Imprime uma cadeia de caracteres HRESULT no console de depuração Gerenciador de Dispositivos. Essa função é fornecida apenas para compatibilidade. Ele é obsoleto e não tem mais suporte. Em vez disso , use WIAS_LHRESULT .

Ler e armazenar propriedades de item

Função	Descrição
wiasCreatePropContext	Aloca um contexto de propriedade para indicar qual das propriedades de um item está mudando.
wiasFreePropContext	Libera a memória ocupada por uma estrutura WIA_PROPERTY_CONTEXT .
wiasGetChangedValueFloat	Determina se uma propriedade com um valor de ponto flutuante foi alterada por um aplicativo.
wiasGetChangedValueGuid	Determina se uma propriedade com um valor GUID foi alterada por um aplicativo.
wiasGetChangedValueLong	Determina se uma propriedade com um valor inteiro longo foi alterada por um aplicativo.
wiasGetChangedValueStr	Determina se uma propriedade com um valor de cadeia de caracteres foi alterada por um aplicativo.
wiasGetItemType	Indica um item raiz ou filho.
wiasGetPropertyAttributes	Recupera os sinalizadores de acesso e os valores válidos para um conjunto de propriedades.
wiasIsPropChanged	Testa se a propriedade especificada foi alterada por um aplicativo.
wiasReadMultiple	Lê várias propriedades de um item WIA.
wiasReadPropBin	Lê uma única propriedade binária de um item WIA.
wiasReadPropFloat	Recupera um valor de propriedade de ponto flutuante de um item WIA.
wiasReadPropGuid	Recupera um valor de propriedade GUID de um item WIA.
wiasReadPropLong	Recupera um valor de propriedade inteiro longo de um item WIA.
wiasReadPropStr	Recupera um valor de propriedade de cadeia de caracteres de um item WIA.
wiasSetItemPropAttribs	Define os sinalizadores de acesso e os valores válidos para o conjunto de propriedades de um item.
wiasSetItemPropNames	Grava nomes de propriedade nas propriedades do item.
wiasSetPropChanged	Modifica um contexto de propriedade para indicar que uma propriedade está sendo alterada.
wiasSetPropertyAttributes	Define os sinalizadores de acesso e os valores de propriedade das propriedades de um item.
wiasSetValidFlag	Define os valores válidos para uma propriedade WIA_PROP_FLAG.
wiasSetValidListFloat	Define os valores válidos para uma propriedade WIA_PROP_LIST do tipo sub-VT_R4.
wiasSetValidListGuid	Define os valores válidos para uma propriedade WIA_PROP_LIST do subtipo VT_CLSID.
wiasSetValidListLong	Define os valores válidos para uma propriedade WIA_PROP_LIST do tipo sub-VT_I4.
wiasSetValidListStr	Define os valores válidos para uma propriedade WIA_PROP_LIST do tipo sub-VT_BSTR.
wiasSetValidRangeFloat	Especifica o intervalo de valores válidos para uma propriedade WIA_PROP_RANGE do subtipo VT_R4.
wiasSetValidRangeLong	Especifica o intervalo de valores válidos para uma propriedade WIA_PROP_RANGE do subtipo VT_I4.
wiasUpdateValidFormat	Atualizações o formato válido do contexto de propriedade para o minidriver atual.
wiasValidateItemProperties	Valida uma lista de propriedades de item simples em relação aos valores válidos atuais.
wiasWriteMultiple	Grava vários valores de propriedade em um item WIA (as propriedades podem ser de tipos diferentes).
wiasWritePropBin	Grava um único valor de propriedade binária em um item WIA.
wiasWritePropFloat	Grava um valor de propriedade de ponto flutuante em um item WIA.
wiasWritePropGuid	Grava um valor da propriedade GUID em um item WIA.
wiasWritePropLong	Grava um valor de propriedade inteiro longo em um item WIA.
wiasWritePropStr	Grava um valor de propriedade de cadeia de caracteres em um item WIA.

Atualizar e transferir dados

Função	Descrição
wiasDownSampleBuffer	Usa um buffer de dados de pixel e reduz o tamanho especificado.
wiasGetImageInformation	Recupera informações de contexto de transferência de um item.
wiasParseEndorserString	Analisa uma cadeia de caracteres de endosso, substituindo tokens definidos pelo serviço WIA e definidos pelo fornecedor na cadeia de caracteres por valores associados aos tokens.
wiasSendEndOfPage	Chama a rotina de retorno de chamada do cliente durante uma transferência de dados, enviando a contagem total de páginas atual.
wiasUpdateScanRect	Atualizações os tamanhos da área de verificação do dispositivo de verificação.
wiasWriteBufToFile	Grava o conteúdo de um buffer de página temporário em um arquivo de imagem.
wiasWritePageBufToFile	Grava o conteúdo de um buffer de página temporário em um arquivo de imagem. Use essa função para gravar uma página em um arquivo TIFF de várias páginas.