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 文件。