WIA 驱动程序服务库

WIA 驱动程序服务库包含 WIA 微型驱动程序可以调用的函数，以协助执行以下任务：

• 生成和维护项树

• 日志错误和跟踪消息

• 读取和存储项属性

• 更新和传输数据

WIA 微型驱动程序根据需要从其 IWiaMiniDrv 接口 方法调用其中大多数函数。 但是，每个 WIA 微型驱动程序必须在 IWiaMiniDrv：:d rvInitializeWia 方法中调用 wiasCreateDrvItem 函数来创建驱动程序项。 每次成功调用 wiasCreateDrvItem 函数都会创建 一个 IWiaDrvItem 项对象，该对象在微型驱动程序的项树中使用。 多个 IWiaDrvItem 接口 方法具有 IWiaDrvItem 类型的参数，包括 IWiaDrvItem：：AddItemToFolder、 IWiaDrvItem：：GetFirstChildItem、 IWiaDrvItem：：GetNextSiblingItem 和 IWiaDrvItem：：GetParentItem。 此外， wiasGetDrvItem 函数具有此类型的参数。

驱动程序服务库提供以下函数。

生成和维护项树

函数	说明
wiasCreateChildAppItem	创建新的应用程序项，并将其作为指定 (父) 项的子项插入。
wiasCreateDrvItem	创建 IWiaDrvItem 对象。
wiasGetChildrenContexts	检索属于当前项的子项的项上下文的数组。
wiasGetContextFromName	检索项名称的项上下文。
wiasGetDrvItem	检索驱动程序项。
wiasGetRootItem	检索指定 WIA 项的根项上下文。

日志错误和跟踪消息

函数	说明
wiasCreateLogInstance	创建日志记录对象的实例。
wiasDebugError	在调试控制台中打印设备管理器调试错误字符串。 输出颜色始终为红色。 提供此函数仅用于兼容性。 建议改用 WIAS_ERROR 。
wiasDebugTrace	在设备管理器调试控制台中打印调试跟踪字符串。 提供此函数仅用于兼容性。 建议改用 WIA_TRACE 。
wiasFormatArgs	将参数列表的格式设置为打包的字符串进行日志记录。
wiasPrintDebugHResult	在设备管理器调试控制台上打印 HRESULT 字符串。 提供此函数仅用于兼容性。 它已过时，不再受支持。 请改 用 WIAS_LHRESULT 。

读取和存储项属性

函数	说明
wiasCreatePropContext	分配属性上下文以指示哪些项的属性正在更改。
wiasFreePropContext	释放 WIA_PROPERTY_CONTEXT 结构占用的内存。
wiasGetChangedValueFloat	确定应用程序是否更改了具有浮点值的属性。
wiasGetChangedValueGuid	确定应用程序是否更改了具有 GUID 值的属性。
wiasGetChangedValueLong	确定应用程序是否更改了具有长整数值的属性。
wiasGetChangedValueStr	确定具有字符串值的属性是否已由应用程序更改。
wiasGetItemType	指示根项或子项。
wiasGetPropertyAttributes	检索一组属性的访问标志和有效值。
wiasIsPropChanged	测试指定的属性是否已由应用程序更改。
wiasReadMultiple	从 WIA 项读取多个属性。
wiasReadPropBin	从 WIA 项读取单个二进制属性。
wiasReadPropFloat	从 WIA 项检索浮点属性值。
wiasReadPropGuid	从 WIA 项检索 GUID 属性值。
wiasReadPropLong	从 WIA 项检索长整数属性值。
wiasReadPropStr	从 WIA 项检索字符串属性值。
wiasSetItemPropAttribs	为项的属性集设置访问标志和有效值。
wiasSetItemPropNames	将属性名称写入项属性。
wiasSetPropChanged	修改属性上下文以指示正在更改属性。
wiasSetPropertyAttributes	设置项属性的访问标志和属性值。
wiasSetValidFlag	设置 WIA_PROP_FLAG 属性的有效值。
wiasSetValidListFloat	设置子VT_R4类型的WIA_PROP_LIST属性的有效值。
wiasSetValidListGuid	设置子类型VT_CLSID WIA_PROP_LIST属性的有效值。
wiasSetValidListLong	设置子VT_I4类型的WIA_PROP_LIST属性的有效值。
wiasSetValidListStr	设置子VT_BSTR类型的WIA_PROP_LIST属性的有效值。
wiasSetValidRangeFloat	指定子类型VT_R4 WIA_PROP_RANGE属性的有效值范围。
wiasSetValidRangeLong	指定子类型VT_I4 WIA_PROP_RANGE属性的有效值范围。
wiasUpdateValidFormat	汇报当前微型驱动程序的属性上下文的有效格式。
wiasValidateItemProperties	根据简单项属性的当前有效值验证其列表。
wiasWriteMultiple	将多个属性值写入 WIA 项， (属性可能是不同类型的) 。
wiasWritePropBin	将单个二进制属性值写入 WIA 项。
wiasWritePropFloat	将浮点属性值写入 WIA 项。
wiasWritePropGuid	将 GUID 属性值写入 WIA 项。
wiasWritePropLong	将长整数属性值写入 WIA 项。
wiasWritePropStr	将字符串属性值写入 WIA 项。

更新和传输数据

函数	说明
wiasDownSampleBuffer	获取像素数据的缓冲区，并将其缩减为指定大小。
wiasGetImageInformation	从项中检索传输上下文信息。
wiasParseEndorserString	分析背书字符串，将字符串中 WIA 服务定义的令牌和供应商定义的令牌替换为与令牌关联的值。
wiasSendEndOfPage	在数据传输期间调用客户端回调例程，发送当前总页计数。
wiasUpdateScanRect	汇报扫描设备的扫描区域大小。
wiasWriteBufToFile	将临时页缓冲区的内容写入图像文件。
wiasWritePageBufToFile	将临时页缓冲区的内容写入图像文件。 使用此函数将页面写入多页 TIFF 文件。