通过

IWiaTransferCallback：：TransferCallback 方法（wia_lh.h）

  • 项目

IWiaTransferCallback：：TransferCallback 方法由图像处理筛选器实现。 WIA 服务通过调用 IWiaTransfer：:D ownload 或预览组件的 IWiaPreview：：GetNewPreview调用 WIA 服务。

语法

HRESULT TransferCallback(
  [in] LONG              lFlags,
  [in] WiaTransferParams *pWiaTransferParams
);

参数

[in] lFlags

当前未使用。 应设置为零。

[in] pWiaTransferParams

指定指向 WiaTransferParams 结构的指针。

返回值

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

言论

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

图像处理筛选器的 IWiaTransferCallback：：TransferCallback 方法必须委托给应用程序回调的 IWiaTransferCallback：：TransferCallback 方法。 在许多情况下，图像处理筛选器的 IWiaTransferCallback：：TransferCallback 实现也必须修改 ulBytesWrittenToCurrentStream，并且也可能是 wiaTransferParams 结构中的 lPercentComplete 值。 如果图像处理筛选器必须在对写入方法的调用之间缓冲图像数据，然后才能将数据写入到应用程序提供的流，则必须修改 ulBytesWrittenToCurrentStream 。 例如，如果正在执行桌面和/或轮换，则需要这样做。 如果不需要旋转或桌面设置，筛选器应最好处理数据带。 lPercentComplete 不一定需要修改，因为此参数指示传输总时间的百分比。 例如，此成员可由应用程序中的进度栏使用。 请注意，图像处理筛选器不应修改结构的 lMessage 成员。 IWiaTransferCallback：：TransferCallback 也不应“吞咽”它接收的任何消息，即使它执行缓冲，而是应修改 ulBytesWrittenToCurrentStream 成员。

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

要求

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