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) |