WIA_DPS_SCAN_AVAILABLE_ITEM

WIA_DPS_SCAN_AVAILABLE_ITEM 属性提供应用程序在程序控制下执行的推送扫描操作的输入源的名称。 WIA 微型驱动程序创建和维护此属性。

属性类型:VT_BSTR

有效值:WIA_PROP_NONE

访问权限:只读

注解

在 Windows 7 及更高版本中,WIA_DPS_SCAN_AVAILABLE_ITEM 是 WIA 扫描程序设备的 WIA 项树中根项的可选属性。 应用程序可以查询此属性以确定输入源 (平板、自动文档送纸器或胶片扫描适配器) 扫描,或者要从中传输数据的存储位置。

某些 WIA 扫描程序设备使用户能够从设备的前面板为扫描作业选择输入源,或者隐式选择输入源,例如,通过将文档插入设备上的送纸器。 当用户在设备上按下“开始扫描”按钮时,应用程序必须确定用户选择了哪个输入源,以便可以在此源上启动扫描操作。

扫描事件通知应用程序用户已启动扫描,但该事件不提供表示输入源的 WIA 项的名称。 应用程序的事件处理程序可以查询根项的 WIA_DPS_SCAN_AVAILABLE_ITEM 属性以获取输入源项的名称。

WIA 树中的根项具有一个或多个子项, (平板项、送纸器项和胶片项) 表示设备上的输入源。 其中每个项可能是表示输入源的各个部分或区域的子项的父项。 作为根项的子级并且表示整体平板的平板项目可以具有子 (这也是表示平板表面的各个区域的平板项) 。 作为根项的子级且表示自动文档送纸器的送纸器项可以具有子项,用于表示通过送纸器的文档页正面和背面的扫描仪。 作为根项的子项并且表示整个胶片扫描适配器的胶片项可以具有子 (这也是表示单个胶片帧) 的胶片项。 根据用户请求的扫描操作,WIA_DPS_SCAN_AVAILABLE_ITEM 属性可以命名作为根子项的平板、送纸器或胶片项,也可以命名其中一项的子项。 有关这些项目的详细信息,请参阅 WIA 项类别

发生扫描事件时,驱动程序会立即将 WIA_DPS_SCAN_AVAILABLE_ITEM 属性值设置为 WIA 项名称, (完全与标识扫描作业可用输入源的项) 的 WIA_IPA_ITEM_NAME 属性所报告的完全一样(如果此信息已知)。 否则,如果输入源未知,驱动程序会将属性值设置为空字符串。 当应用程序使用扫描事件时,扫描事件的状态将从“已发出信号”更改为“无信号”,驱动程序会将WIA_DPS_SCAN_AVAILABLE_ITEM属性值重置为空字符串。

有关此属性的详细信息,请参阅 标识扫描事件的输入源

要求

标头:wiadef.h(包括 Wiadef.h)

另请参阅

WIA_IPA_ITEM_NAME