IWiaImageFilter::InitializeFilter 方法 (wia_lh.h)

IWiaImageFilter::InitializeFilter 方法存储对传递到方法中的 pWiaItem2pWiaTransferCallback 参数的引用。

语法

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

参数

[in] pWiaItem2

指向应用程序为其启动图像获取的 IWiaItem2 项。 对于 IWiaTransfer::D ownload,它是我们从中获取 IWiaTransfer 接口的 WIA 项,对于预览组件,它是我们传入 IWiaPreview::GetNewPreview 方法的项。

[in] pWiaTransferCallback

指向 IWiaTransferCallback 接口。 IWiaTransferCallback 接口是应用程序的回调接口,它传递给 IWiaTransfer::D ownloadIWiaPreview::GetNewPreview

返回值

成功时返回S_OK,失败时返回标准 COM 错误代码。

注解

在下载调用到达 WIA 服务之前,COM 代理对象会调用此方法。 这在两种情况下发生:当应用程序调用 IWiaTransfer::D ownload 方法和应用程序调用 IWiaPreview::GetNewPreview 方法时。

IWiaImageFilter::InitializeFilter 需要做的就是存储传入它的 pWiaItem2pWiaTransferCallback 的引用。 这些接口指针应存储为此方法中的成员变量,并应为每个接口指针调用 AddRefIWiaTransferCallback::TransferCallback 和 IWiaTransferCallback:GetNextStream 方法的筛选器实现中需要这两个接口指针。

应用程序不能直接调用此方法。

要求

要求
目标平台 桌面
标头 wia_lh.h (包括 Wia_lh.h)

另请参阅

IWiaImageFilter

IWiaItem2

IWiaPreview::GetNewPreview

IWiaTransferCallback

IWiaTransfer::D ownload