通过

IWiaTransferCallback：：GetNextStream 方法 （wia_lh.h）

  • 项目

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

语法

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 错误值。

言论

当 WIA 微型驱动程序从客户端请求目标流以及微型驱动程序将进度消息发送回应用程序时，将调用图像处理筛选器实现 IWiaTransferCallback 和 IWiaTransferCallback：：TransferCallback。

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

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

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

要求

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

另请参阅

IWiaImageFilter：：InitializeFilter

IWiaTransferCallback