WIA 传输常量

  • 项目

本主题包含用于基于 WIA IStream 的传输的常量列表。

这些常量分为三个子组：

  • 项目类型

  • 回调消息

  • 传输标志

项目类型

下表显示了哪些 WIA 项类型位与基于流的数据传输相关。

名称 说明
WiaItemTypeTransfer 应在能够传输数据的所有项上设置此 WIA_IPA_ITEM_FLAGS 位;也就是说，应用程序可以在设置了此位的项上启动下载或上传。

回调消息

下表显示了 IWiaTransferCallback：：TransferCallback 的 lFlags 参数的可能值。

名称 说明
WIA_TRANSFER_MSG_STATUS 通知应用程序传输进度。

pWiaTransferParams-lPercentComplete> 包含此项和正在传输的页面的完成百分比。
WIA_TRANSFER_MSG_END_OF_STREAM 通知应用程序，不再有数据要传输到当前数据流，并且该流可能已关闭。

随后可能会在多项目或多页传输中请求新流。

驱动程序不会手动发送此消息。 当驱动程序请求下一个流时，WIA 服务将自动发送此消息。
WIA_TRANSFER_MSG_END_OF_TRANSFER 在传输结束时由应用程序接收。

驱动程序不会发送此消息。 WIA 服务将在传输结束后自动发送此消息， (即，对 IWiaMiniDrv：:d rvAcquireItemData 的调用将返回) 。
WIA_TRANSFER_MSG_ERROR 由 Microsoft 保留以供将来使用。
WIA_TRANSFER_MSG_DEVICE_STATUS 指示在传输 (期间出错，例如，) 卡纸。

pWiaTransferParams-hrErrorStatus> 包含错误状态代码。
WIA_TRANSFER_MSG_NEW_PAGE 指示在使用一个文件 (中支持多个页面的格式（如多文件 TIFF) ）时，在多页传输期间传输新页面。

传输标志

下表显示了可能传递到 IWiaMiniDrv：:d rvAcquireItemData 的标志。

名称 说明
WIA_MINIDRV_TRANSFER_DOWNLOAD 指示传输是基于流的下载操作 (即，从设备到应用程序) 数据传输。

应用程序不会直接设置此位。 如果应用程序调用 IWiaTransfer：:D ownload，WIA 服务将设置此位。
WIA_MINIDRV_TRANSFER_UPLOAD 指示传输是基于流的上传操作， (即，从应用程序到设备的数据传输) 。

应用程序不会直接设置此位。 如果应用程序调用 IWiaTransfer：：Upload，WIA 服务将设置此位。
WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN 指示驱动程序应执行文件夹传输。 如果对文件夹项调用此值，则应用程序会请求传输该文件夹的子级。

如果应用程序通过将 IWiaTransfer：:D ownload 的 lFlags 参数设置为 WIA_TRANSFER_ACQUIRE_CHILDREN 请求文件夹传输，并且驱动程序已指定它可以在一次扫描中传输多个子级，则将设置此值。 如果驱动程序无法执行此类传输，WIA 服务将对驱动程序进行多次调用，并且 不会 设置WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN。