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
指定指定回调状态消息的常量值。 此值用于确定回调的目的，可以是以下值之一：
| 消息 | 定义 |
|---|---|
| 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） |