Método IWiaTransferCallback::TransferCallback (wia_lh.h)

Artigo
02/27/2024

O método IWiaTransferCallback::TransferCallback é implementado por um filtro de processamento de imagem. Ele é chamado pelo serviço WIA como resultado de um aplicativo que chama IWiaTransfer::D ownload ou IWiaPreview::GetNewPreview do componente de visualização.

Sintaxe

HRESULT TransferCallback(
  [in] LONG              lFlags,
  [in] WiaTransferParams *pWiaTransferParams
);

Parâmetros

[in] lFlags

Atualmente não utilizado. Deve ser definido como zero.

[in] pWiaTransferParams

Especifica um ponteiro para uma estrutura WiaTransferParams .

Retornar valor

Retorna S_OK se tiver êxito ou um valor de erro COM padrão, caso contrário.

Comentários

A implementação de um filtro de processamento de imagem do método IWiaTransferCallback::TransferCallback é chamada durante a aquisição da imagem, quando o mini driver WIA solicita o fluxo de destino do cliente e quando o mini driver envia mensagens de progresso de volta para o aplicativo.

O método IWiaTransferCallback::TransferCallback de um filtro de processamento de imagem deve delegar ao método IWiaTransferCallback::TransferCallback do retorno de chamada do aplicativo. Em muitos casos, a implementação IWiaTransferCallback::TransferCallback do filtro de processamento de imagem também precisará modificar o ulBytesWrittenToCurrentStream e, possivelmente, também os valores lPercentComplete na estrutura WiaTransferParams. ulBytesWrittenToCurrentStream deverá ser modificado se o filtro de processamento de imagem precisar armazenar em buffer dados de imagem entre chamadas ao método Write antes de gravar os dados no fluxo fornecido pelo aplicativo. Isso, por exemplo, seria necessário se dessekewing e/ou rotação se estiver sendo executado. Se nenhuma rotação ou desação for necessária, o filtro deverá funcionar preferencialmente em faixas de dados. No entanto, o lPercentComplete não precisa necessariamente ser modificado, pois esse parâmetro indica o percentual do tempo total de transferência. Esse membro pode, por exemplo, ser usado por uma barra de progresso em um aplicativo. Observe que o filtro de processamento de imagem não deve modificar o membro lMessage da estrutura. IWiaTransferCallback::TransferCallback também não deve "engolir" as mensagens recebidas mesmo que execute o buffer, mas deve modificar o membro ulBytesWrittenToCurrentStream .

Esse método não é chamado pelo componente de visualização durante IWiaPreview::UpdatePreview.

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	wia_lh.h (inclua Wia_lh.h)

Compartilhar via