Função wiasGetImageInformation (wiamdef.h)
A função wiasGetImageInformation recupera informações de contexto de transferência de um item.
Sintaxe
HRESULT wiasGetImageInformation(
[in] BYTE *pWiasContext,
LONG lFlags,
[in, out] PMINIDRV_TRANSFER_CONTEXT pmdtc
);
Parâmetros
[in] pWiasContext
Ponteiro para um contexto de item WIA.
lFlags
Especifica sinalizadores operacionais. Atualmente, somente o seguinte sinalizador é definido:
| Sinalizador | Significado |
|---|---|
| WIAS_INIT_CONTEXT | Inicialize a estrutura de MINIDRV_TRANSFER_CONTEXT. |
[in, out] pmdtc
Ponteiro para uma estrutura de MINIDRV_TRANSFER_CONTEXT . Após o retorno, essa estrutura contém as informações de item de imagem solicitadas.
Retornar valor
Em caso de êxito, a função retorna S_OK.
Se a função falhar, ela retornará um erro COM padrão ou um dos códigos de erro wia.
Comentários
Essa função usa uma estrutura MINIDRV_TRANSFER_CONTEXT para calcular tamanhos de cabeçalho de item e imagem de item. Além disso, ele pode, opcionalmente, preencher um cabeçalho de imagem se o formato de imagem exigir um cabeçalho de dados. O cabeçalho será copiado para o buffer se o membro pTransferBuffer da estrutura MINIDRV_TRANSFER_CONTEXT não for NULL. Ao usar formatos de imagem (como JPEG) que não têm um cabeçalho, o tamanho do cabeçalho no membro lHeaderSize da estrutura MINIDRV_TRANSFER_CONTEXT é relatado como zero.
Para formatos de imagem em que o tamanho final real da imagem não é conhecido até após a aquisição de dados, como com tiff de várias páginas e formatos compactados, o membro lItemSize da estrutura MINIDRV_TRANSFER_CONTEXT é relatado como zero. O membro lImageSize é relatado como o tamanho, em bytes, da imagem não compactada em uma única página.
Se WIAS_INIT_CONTEXT for especificado no parâmetro lFlags , a estrutura MINIDRV_TRANSFER_CONTEXT apontada pelo parâmetro pmdtc será preenchida com informações derivadas das propriedades de imagem do item. Esse sinalizador deve ser usado quando um minidriver aloca um novo contexto.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | wiamdef.h (inclua Wiamdef.h) |
| Biblioteca | Wiaservc.lib |
| DLL | Wiaservc.dll |