Método IWiaImageFilter::InitializeFilter (wia_lh.h)
O método IWiaImageFilter::InitializeFilter armazena as referências para pWiaItem2 e parâmetros de pWiaTransferCallback passados para o método.
Sintaxe
HRESULT InitializeFilter(
[in] IWiaItem2 *pWiaItem2,
[in] IWiaTransferCallback *pWiaTransferCallback
);
Parâmetros
[in] pWiaItem2
Aponta para o item deIWiaItem2 para o qual a aquisição da imagem foi iniciada pelo aplicativo. No caso de IWiaTransfer::D ownload, é o item WIA do qual obtivemos a interfaceIWiaTransfere, no caso do componente Preview, é o item que passamos para o método IWiaPreview::GetNewPreview.
[in] pWiaTransferCallback
Aponta para uma interface deIWiaTransferCallback. A interface IWiaTransferCallback é a interface de retorno de chamada do aplicativo, que é passada para IWiaTransfer::D ownload e IWiaPreview::GetNewPreview.
Valor de retorno
Retorna S_OK com êxito ou um código de erro COM padrão sobre falha.
Observações
Esse método é chamado pelo objeto proxy COM antes que a chamada de download chegue ao serviço WIA. Isso acontece em dois casos: quando um aplicativo chama método IWiaTransfer::D ownload e quando um aplicativo chama o método IWiaPreview::GetNewPreview.
Tudo o que IWiaImageFilter::InitializeFilter é necessário fazer é armazenar as referências para pWiaItem2 e pWiaTransferCallback que são passadas para ele. Esses ponteiros de interface devem ser armazenados como variáveis membro neste método e AddRef devem ser chamados para cada ponteiro de interface. Esses dois ponteiros de interface são necessários na implementação do filtro de métodos IWiaTransferCallback::TransferCallback e IWiaTransferCallback::GetNextStream.
Esse método não pode ser invocado diretamente pelo aplicativo.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | wia_lh.h (inclua Wia_lh.h) |