Método IWiaImageFilter::InitializeFilter (wia_lh.h)

Artigo
02/29/2024

O método IWiaImageFilter::InitializeFilter armazena as referências aos parâmetros pWiaItem2 e pWiaTransferCallback passados para o método .

Sintaxe

HRESULT InitializeFilter(
  [in] IWiaItem2            *pWiaItem2,
  [in] IWiaTransferCallback *pWiaTransferCallback
);

Parâmetros

[in] pWiaItem2

Aponta para o item IWiaItem2 para o qual a aquisição de imagem foi iniciada pelo aplicativo. No caso de IWiaTransfer::D ownload, é o item WIA do qual obtivemos a interface IWiaTransfer e, no caso do componente Preview, é o item que passamos para o método IWiaPreview::GetNewPreview .

[in] pWiaTransferCallback

Aponta para uma interface IWiaTransferCallback . A interface IWiaTransferCallback é a interface de retorno de chamada do aplicativo, que é passada para IWiaTransfer::D ownload e IWiaPreview::GetNewPreview.

Retornar valor

Retorna S_OK em caso de êxito ou um código de erro COM padrão em caso de falha.

Comentários

Esse método é chamado pelo objeto proxy COM antes que a chamada de download atinja o serviço WIA. Isso acontece em dois casos: quando um aplicativo chama o método IWiaTransfer::D ownload e quando um aplicativo chama o método IWiaPreview::GetNewPreview .

Tudo o que IWiaImageFilter::InitializeFilter deve fazer é armazenar as referências a pWiaItem2 e pWiaTransferCallback que são passadas para ele. Esses ponteiros de interface devem ser armazenados como variáveis de membro nesse método e AddRef deve ser chamado para cada ponteiro de interface. Esses dois ponteiros de interface são necessários na implementação do filtro dos métodos IWiaTransferCallback::TransferCallback e IWiaTransferCallback::GetNextStream .

Esse método não pode ser invocado diretamente pelo aplicativo.