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) |