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:
| Bandeira | Significado |
|---|---|
| WIAS_INIT_CONTEXT | Inicialize a estrutura de MINIDRV_TRANSFER_CONTEXT. |
[in, out] pmdtc
Ponteiro para uma estrutura MINIDRV_TRANSFER_CONTEXT. Após o retorno, essa estrutura contém as informações de item de imagem solicitadas.
Valor de retorno
Com ê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 .
Observações
Essa função usa uma estrutura MINIDRV_TRANSFER_CONTEXT para calcular os tamanhos de imagem do item e do cabeçalho do item. Além disso, ele poderá preencher opcionalmente 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 pTransferBuffer membro da estrutura MINIDRV_TRANSFER_CONTEXT não estiver NULL. Ao usar formatos de imagem (como JPEG) que não têm um cabeçalho, o tamanho do cabeçalho no lHeaderSize membro da estrutura MINIDRV_TRANSFER_CONTEXT é relatado como zero.
Para formatos de imagem em que o tamanho final real da imagem não é conhecido até depois da aquisição de dados, como com tiff de várias páginas e formatos compactados, o lItemSize membro da estrutura MINIDRV_TRANSFER_CONTEXT é relatado como zero. O membro lImageSize é relatado como o tamanho, em bytes, da imagem descompactada 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 |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | wiamdef.h (inclua Wiamdef.h) |
| biblioteca | Wiaservc.lib |
| de DLL | Wiaservc.dll |