Метод IWiaImageFilter::InitializeFilter (wia_lh.h)

Метод IWiaImageFilter::InitializeFilter хранит ссылки на параметры pWiaItem2 и pWiaTransferCallback , переданные в метод.

Синтаксис

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

Параметры

[in] pWiaItem2

Указывает на элемент IWiaItem2 , для который было инициировано приложением приобретение образа. В случае IWiaTransfer::D ownload это элемент WIA, из которого мы получили интерфейс IWiaTransfer , а в случае компонента Preview это элемент, который мы передаем в метод IWiaPreview::GetNewPreview .

[in] pWiaTransferCallback

Указывает на интерфейс IWiaTransferCallback . Интерфейс IWiaTransferCallback — это интерфейс обратного вызова приложения, который передается в IWiaTransfer::D ownload и IWiaPreview::GetNewPreview.

Возвращаемое значение

Возвращает S_OK при успешном выполнении или стандартный код ошибки COM при сбое.

Замечания

Этот метод вызывается объектом прокси-сервера COM до того, как вызов загрузки достигнет службы WIA. Это происходит в двух случаях: когда приложение вызывает метод IWiaTransfer::D ownload и когда приложение вызывает метод IWiaPreview::GetNewPreview .

Все, что требуется для IWiaImageFilter::InitializeFilter , заключается в хранении ссылок на pWiaItem2 и pWiaTransferCallback , передаваемых в него. Эти указатели интерфейса должны храниться в виде переменных-членов в этом методе, и Для каждого указателя интерфейса следует вызывать AddRef . Эти два указателя интерфейса необходимы в реализации методов IWiaTransferCallback::TransferCallback и IWiaTransferCallback::GetNextStream .

Этот метод нельзя вызвать непосредственно приложением.

Требования

См. также

IWiaImageFilter

IWiaItem2

IWiaPreview::GetNewPreview

IWiaTransferCallback

IWiaTransfer::D ownload