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 的引用。 这些接口指针应作为成员变量存储在此方法中,应为每个接口指针调用 AddRef。 在筛选器的 IWiaTransferCallback::TransferCallbackIWiaTransferCallback::GetNextStream 方法的实现中需要这两个接口指针。

应用程序无法直接调用此方法。

要求

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

另请参阅

IWiaImageFilter

IWiaItem2

IWiaPreview::GetNewPreview

IWiaTransferCallback

IWiaTransfer::D ownload