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

Статья
02/29/2024

Метод 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 .

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