IWiaImageFilter::InitializeFilter 方法

初始化筛选器。 在每次下载映像之前,由 Windows 映像获取 (WIA) 2.0 调用。

语法

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

参数

pWiaItem2 [in]

类型: IWiaItem2*

指定指向表示预览图像的 IWiaItem2 项的指针。

pWiaTransferCallback [in]

类型: IWiaTransferCallback*

指定指向应用程序的 IWiaTransferCallback 接口的指针。

返回值

类型: HRESULT

如果此方法成功,则返回 S_OK。 否则,它将返回 HRESULT 错误代码。

备注

当应用程序调用 Download 和应用程序调用 WIA 2.0 预览组件的 GetNewPreview 函数时,将调用此方法。 IWiaImageFilter::InitializeFilter 存储对 pWiaItem2pWiaTransferCallback 的引用,以传入这些函数。 这两个接口指针应存储为成员变量,并且应为每个接口指针调用 IUnknown::AddRef 。 在图像获取期间 ,在 TransferCallbackGetNextStream 的筛选器实现中也需要接口指针。

要求

要求
最低受支持的客户端
Windows Vista [仅限桌面应用]
最低受支持的服务器
Windows Server 2008 [仅限桌面应用]
标头
Wia.h
IDL
Wia.idl