IWiaMiniDrvCallBack：：MiniDrvCallback 方法 (wiamindr_lh.h)

  • 项目

MiniDrvCallback 方法为 WIA 微型驱动程序提供回调方法，以便在回调数据传输期间使用。

语法

HRESULT MiniDrvCallback(
  [in] LONG                      lReason,
  [in] LONG                      lStatus,
  [in] LONG                      lPercentComplete,
  [in] LONG                      lOffset,
  [in] LONG                      lLength,
  [in] PMINIDRV_TRANSFER_CONTEXT pTranCtx,
  [in] LONG                      lReserved
);

参数

[in] lReason

指定指定回调状态消息的常量值。 此值用于确定回调的用途，可以是以下值之一：

Message 定义
IT_MSG_DATA 指示传输缓冲区包含数据块。
IT_MSG_DATA_HEADER 在任何数据传输之前接收。 指示传输缓冲区指向定义数据传输元素 的WIA_DATA_CALLBACK_HEADER 结构。
IT_MSG_DEVICE_STATUS 回调仅包含有关设备的状态信息。
IT_MSG_FILE_PREVIEW_DATA 指示预览数据正在传输到应用程序。
IT_MSG_FILE_PREVIEW_DATA_HEADER 指示在传输预览数据之前，正在将标头传输到应用程序。
IT_MSG_NEW_PAGE 指示页面的数据传输已完成，并且正在发送新页面。
IT_MSG_STATUS 回调仅包含有关传输的状态信息。
IT_MSG_TERMINATION 指示数据传输已完成。

[in] lStatus

指定传输的状态。 此参数是以下值的按位 OR：

状态 定义
IT_STATUS_TRANSFER_FROM_DEVICE 从设备传输数据。
IT_STATUS_PROCESSING_DATA 设备和/或微型驱动程序正在处理数据。
IT_STATUS_TRANSFER_TO_CLIENT 将数据从微型驱动程序传输到 WIA 服务。

[in] lPercentComplete

指定当前传输的数据百分比。

[in] lOffset

指定从缓冲区开头) 传输缓冲区的当前偏移量 (字节数。

[in] lLength

指定传输中包含的字节数。

[in] pTranCtx

指向包含数据传输值的 MINIDRV_TRANSFER_CONTEXT 结构。

[in] lReserved

保留。 设置为零。

返回值

如果方法成功，则返回 S_OK。 如果客户端应用程序取消了回调，该方法将返回 S_FALSE。 如果方法失败，则返回标准 COM 错误代码。

注解

完成百分比值直接从驱动程序发送。 WIA 服务不调整值。

IT_MSG_FILE_PREVIEW_DATA_HEADER 适用于带外数据。 这样，执行文件传输的应用程序就可以显示带状数据。 这对于长度未知且无预览扫描的滚动扫描程序很有用。 此消息中报告的信息应与 IT_MSG_DATA_HEADER相同。 如果驱动程序支持此消息，它可以在文件传输期间提供预览数据。

要求

要求 值
目标平台 桌面
标头 wiamindr_lh.h (包括 Wiamindr.h)

另请参阅

IWiaMiniDrvCallBack

MINIDRV_TRANSFER_CONTEXT