IWiaImageFilter::InitializeFilter 方法(wia_lh.h)
IWiaImageFilter::InitializeFilter 方法存储对 pWiaItem2 和 pWiaTransferCallback 参数的引用。
语法
HRESULT InitializeFilter(
[in] IWiaItem2 *pWiaItem2,
[in] IWiaTransferCallback *pWiaTransferCallback
);
参数
[in] pWiaItem2
指向应用程序启动映像获取的 IWiaItem2 项。 对于 IWiaTransfer::D ownload,它是从中获取 IWiaTransfer 接口的 WIA 项,在预览组件中,它是传入 IWiaPreview::GetNewPreview 方法的项。
[in] pWiaTransferCallback
指向 IWiaTransferCallback 接口。 IWiaTransferCallback 接口是应用程序的回调接口,该接口传递给 IWiaTransfer::D ownload,IWiaPreview::GetNewPreview。
返回值
返回成功时S_OK,或失败时的标准 COM 错误代码。
言论
在下载调用到达 WIA 服务之前,COM 代理对象调用此方法。 这种情况发生在两种情况下:当应用程序调用 IWiaTransfer::D ownload 方法时,当应用程序调用 IWiaPreview::GetNewPreview 方法时。
必须执行 IWiaImageFilter::InitializeFilter 来存储对 pWiaItem2 和 pWiaTransferCallback 的引用。 这些接口指针应作为成员变量存储在此方法中,应为每个接口指针调用 AddRef。 在筛选器的 IWiaTransferCallback::TransferCallback 和 IWiaTransferCallback::GetNextStream 方法的实现中需要这两个接口指针。
应用程序无法直接调用此方法。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | wia_lh.h (包括 Wia_lh.h) |