IWiaTransferCallback::GetNextStream 方法 (wia_lh.h)

IWiaTransferCallback::GetNextStream 方法由图像处理筛选器实现。 由于应用程序调用 IWiaTransfer::D ownload 或预览组件的 IWiaPreview::GetNewPreview] (/windows/win32/wia/-wia-iwiapreview-getnewpreview) ,WIA 服务会调用它。

语法

HRESULT GetNextStream(
  [in]  LONG    lFlags,
  [in]  BSTR    bstrItemName,
  [in]  BSTR    bstrFullItemName,
  [out] IStream **ppDestination
);

参数

[in] lFlags

保留,设置为零。

[in] bstrItemName

指定包含项名称的字符串。

[in] bstrFullItemName

指定包含项的全名的字符串。

[out] ppDestination

指定指向输出流的指针。

返回值

如果成功,则返回S_OK,否则返回标准 COM 错误值。

注解

图像处理筛选器的 IWiaTransferCallback::GetNextStreamIWiaTransferCallback::TransferCallback 的实现是在映像获取期间调用的,当 WIA 微型驱动程序从客户端请求目标流时,以及微型驱动程序将进度消息发送回应用程序时。

图像处理筛选器的 IWiaTransferCallback::GetNextStream 的实现必须委托给应用程序的 IWiaTransferCallback::GetNextStream 方法。 然后,图像处理筛选器使用应用程序回调的 IWiaTransferCallback::GetNextStream 实现返回的流来创建自己的流, (它传回 WIA 服务的“筛选流”) 。

在其 IWiaTransferCallback::GetNextStream 实现中,图像处理筛选器应从要为其获取图像的项读取其图像处理所需的属性。 筛选器不得直接从传递到 IWiaImageFilter::InitializeFilterpWiaItem2 读取属性;它必须对此 WIA 项调用 IWiaItem2::FindItemByName] (/windows/win32/wia/-wia-iwiaitem2-finditembyname) 以获取实际的 WIA 项。 原因是在文件夹传输期间,获取的图像对应于 pWiaItem2 的子项,而不是 pWiaItem2 本身。

IWiaPreview::UpdatePreview 期间,预览组件不会调用此方法。

要求

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

另请参阅

IWiaImageFilter::InitializeFilter

IWiaTransferCallback