Método IWiaTransferCallback::TransferCallback

Fornece progresso e outras notificações durante uma transferência.

Sintaxe

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

Parâmetros

lFlags [in]

Tipo: LONG

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

pWiaTransferParams [in]

Tipo: WiaTransferParams*

Especifica um ponteiro para uma estrutura WiaTransferParams .

Valor retornado

Tipo: HRESULT

Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

Quando esse método é implementado por um filtro de processamento de imagem, o minidriver de Aquisição de Imagem do Windows (WIA) 2.0 o chama durante a aquisição da imagem para enviar mensagens de progresso de volta ao aplicativo.

IWiaTransferCallback::TransferCallback de um filtro deve delegar ao método IWiaTransferCallback::TransferCallback do retorno de chamada do aplicativo. Normalmente, o fluxo de filtro filtra os dados passados para ele e grava os dados filtrados diretamente no fluxo fornecido pelo aplicativo. Quando o filtro de processamento de imagem armazena dados entre chamadas para seu método IStream::Write , ele também deve modificar os valores lPercentComplete e ulBytesWrittenToCurrentStream na estrutura WiaTransferParams .

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]
Cabeçalho	Wia.h
IDL	Wia.idl
Biblioteca	Wiaguid.lib