扫描程序设备属性常量

  • 项目

Windows 映像采集 (WIA) 硬件设备具有存储在 Windows 注册表中的属性值。 有关详细信息，请参阅 通用设备属性常量。 以下设备属性常量及其关联的字符串特定于数字图像扫描仪。

前缀“WIA_DPS_”指示扫描程序设备的 Device 属性，是 C/C++ 中使用的命名约定。 出于脚本编写目的，这些常量使用前缀“ScannerDevice”，并且是 WiaItemPropertyId 枚举类型的一部分。 该脚本枚举中的相应成员名称显示在以下列表中的 C/C++ 常量名称旁边的括号中。

常量/值 说明
WIA_DPS_DEVICE_ID
ScannerDeviceDeviceId
 注意：
此属性仅在 Windows Vista 及更高版本上受支持。


包含 Web 服务扫描程序设备的唯一函数实例标识符。 此标识符表示 WIA 微型驱动程序与之通信的扫描程序设备上的 Web 服务。 不应对此标识符的形式做出假设。 WIA 微型驱动程序创建和维护此属性。
WIA 应用程序可以使用 WIA_DPS_DEVICE_ID 的值，通过函数发现 API 查找表示当前 WIA 2.0 会话中使用的 Web 服务扫描程序设备的函数实例对象。
类型： VT_BSTR，访问：只读，有效值： WIA_PROP_NONE
WIA_DPS_DITHER_PATTERN_DATA
 保留，请勿使用。
类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE
WIA_DPS_DITHER_SELECT
 保留，请勿使用。
类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE
WIA_DPS_DOCUMENT_HANDLING_CAPABILITIES
ScannerDeviceDocumentHandlingCapabilities
 包含扫描程序的功能。 微型驱动程序创建和维护此属性。
应用程序读取此属性以确定扫描仪是否安装了平板、文档送纸器或双工器。 此属性还用于进一步定义已安装的功能。
类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE
下表描述了仅在 Windows 7 中有效的常量。
Flags 说明
AUTO_SOURCE 扫描程序安装了自动文档处理程序。

 

下表描述了仅在 Windows 7 和 Windows Vista 中有效的常量。

Flags 说明
ADVANCED_DUP 设备支持高级双工扫描配置。 使用 WIA_IPS_DUPLEX_SETTINGS 在使用基本和高级双工配置之间切换。
DETECT_FILM_TPA 扫描程序可以检测透明度/胶片适配器何时准备好扫描。
DETECT_STOR 扫描程序可以检测内部存储中是否有文档。
FILM_TPA 扫描仪配备了透明/胶片扫描适配器。
STOR 扫描程序配备了内部图像存储设备。

 

下表描述了在 Windows XP 或更高版本中有效的常量。

Flags 说明
DETECT_FEED 扫描仪可以检测送纸器中的文档。
DETECT_FLAT 扫描仪可以检测平板上的文档。
DETECT_SCAN 扫描程序只能通过扫描来检测送纸器中的文档。
DUP 扫描程序具有双工器。
饲料 扫描程序安装了自动文档处理程序。
平 扫描仪有平板板。

 

下表描述了仅在 Windows XP 中有效的常量。 这些值已在 Windows 7 和 Windows Vista 中弃用，不应使用。

Flags 说明
DETECT_DUP 扫描程序可以检测来自用户的双工扫描请求。
DETECT_DUP_AVAIL 扫描程序可以判断何时安装了双工器。
DETECT_FEED_AVAIL 扫描程序可以判断何时安装了自动文档送纸器。

 
WIA_DPS_DOCUMENT_HANDLING_SELECT
ScannerDeviceDocumentHandlingSelect

注意：
Windows Vista 及更高版本不支持此属性。 使用 WIA_IPS_DOCUMENT_HANDLING_SELECT。

 

包含当前扫描程序获取源和模式。微型驱动程序创建和维护此属性。

应用程序读取此属性以确定扫描程序的当前获取源，或写入此属性以设置扫描程序的源和模式。 此外，应用程序使用此属性来启用和禁用双工器功能。

类型： VT_I4，访问：读/写，有效值： WIA_PROP_FLAG

下表包含对此属性有效的十个常量。

Flags 说明
馈线 使用文档送纸器进行扫描。
平板 使用平板进行扫描。
双工 使用双工器操作进行扫描。
AUTO_ADVANCE 启用扫描后下一个文档的自动馈送。
FRONT_FIRST 首先扫描文档的正面。 设置双工时，此值有效。
BACK_FIRST 首先扫描文档的背面。 设置双工时，此值有效。
FRONT_ONLY 仅扫描正面。 设置双工时，此值有效。
BACK_ONLY 仅扫描背面。 设置双工时，此值有效。
NEXT_PAGE 扫描文档的下一页。
PREFEED 启用预馈送模式。 扫描时预先定位下一个文档。

 
WIA_DPS_DOCUMENT_HANDLING_STATUS
ScannerDeviceDocumentHandlingStatus

包含扫描程序安装的平板、文档送纸器或双工器的当前状态。 微型驱动程序创建和维护此属性。

应用程序读取此属性以确定扫描程序设备是否已准备好使用。 这是在获取图像之前检查纸张是否在送纸器中的理想方法。

类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE

下表包含对此属性有效的常量。星号 * 表示该标志在 Windows Vista 或更高版本中不受支持。 V 符号指示标志仅在 Windows Vista 及更高版本中受支持。

Flags 说明
FEED_READY 平板已准备就绪，可供使用。
FLAT_READY 扫描仪在平板板上有一个文档。
DUP_READY 双工器已启用，可供使用。
FLAT_COVER_UP 平床盖起来了。
PATH_COVER_UP 纸张路径被遮盖，导致无法正常操作。
PAPER_JAM 文档送纸器中卡住文档。
FILM_TPA_READYV 透明度适配器已安装并可供使用。
STORAGE_READYV 内部存储设备已准备就绪。
STORAGE_FULLV 存储已满，无法执行上传操作。
MULTIPLE_FEEDV 多源条件通常 (PAPER_JAM) 发生。
DEVICE_ATTENTIONV 存在需要用户干预设备上的错误。
LAMP_ERRV 由于灯问题，扫描仪未准备就绪。

 
WIA_DPS_ENDORSER_CHARACTERS
ScannerDeviceEndorserCharacters

包含应用程序可用于创建有效背书字符串的所有有效字符。 代言人是安装在扫描仪上的打印机，在扫描的每个页面上都印有文本消息。 微型驱动程序应根据此属性中的有效字符集验证 WIA_DPS_ENDORSER_STRING 属性的设置。 微型驱动程序创建和维护此属性。

类型： VT_BSTR，访问：只读，有效值： WIA_PROP_NONE
WIA_DPS_ENDORSER_STRING
ScannerDeviceEndorserString

包含一个要 (认可的字符串，换言之，在微型驱动程序扫描的每个页面上打印) 。 应用程序使用 在 WIA_DPS_ENDORSER_CHARACTERS 属性中报告的有效字符集设置此属性。 仅当在此属性中设置了字符串时，微型驱动程序才应认可文档。 空字符串表示已禁用背书人功能。

由于驱动程序负责解释背书字符串，因此驱动程序可以在 WIA_DPS_ENDORSER_STRING中使用特殊字符。 但是，只有应用程序才能理解这些字符。

类型： VT_BSTR，访问：读/写，有效值： WIA_PROP_NONE

支持 WIA_DPS_ENDORSER_STRING 属性的 驱动程序必须支持以下标记列表。

令牌 说明
$DATE$ 格式为 YYYY/MM/DD 的日期。
$DAY$ 格式为 DD 的日期。
$MONTH$ 一年中的月份，格式为 MM。
$PAGE_COUNT$ 传输的页数。
$TIME$ 一天中的时间，格式为 HH：MM：SS。
$YEAR$ 格式为 YYYY 的年份。

 
WIA_DPS_FILTER_SELECT

保留，请勿使用。

类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE
WIA_DPS_GLOBAL_IDENTITY
ScannerDeviceGlobalIdentity

注意：
此属性仅在 Windows Vista 及更高版本上受支持。

 

包含 Web 服务扫描程序设备的 SOAP 地址。 WIA 2.0 微型驱动程序创建和维护此属性。

类型： VT_BSTR，访问：只读，有效值： WIA_PROP_NONE
WIA_DPS_HORIZONTAL_BED_REGISTRATION
ScannerDeviceHorizontalBedRegistration

注意：
Windows Vista 及更高版本不支持此属性。

 

包含放置在平板上的文档的注册或水平对齐方式。 微型驱动程序创建和维护此属性。

类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE

下表包含对此属性有效的三个常量。

一直 说明
LEFT_JUSTIFIED 论文保持合理。
中心 纸张居中。
RIGHT_JUSTIFIED 这篇论文是正确的。

 

另请参阅

WIA_DPS_VERTICAL_BED_REGISTRATION
WIA_DPS_HORIZONTAL_BED_SIZE
ScannerDeviceHorizontalBedSize

注意：
Windows Vista 及更高版本不支持此属性。 使用 WIA_IPS_MAX_HORIZONTAL_SIZE。

 

指定在水平 (X) 轴上扫描的最大宽度（以千分之一英寸为单位），该宽度从平板扫描仪的板片以当前分辨率扫描。 此属性也适用于自动文档馈送器，用于将工作表移动到平板扫描仪的版式进行扫描。 对于具有平板的扫描仪，此属性是必需的。 其他扫描程序类型将改为实现 WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE 属性。

类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE
WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceHorizontalSheetFeedSize

注意：
Windows Vista 及更高版本不支持此属性。 使用 WIA_IPS_MAX_HORIZONTAL_SIZE。

 

指定在水平 (X) 轴上以当前分辨率从手持扫描仪或工作表进纸扫描仪扫描的最大宽度（以千分之一英寸为单位）。 此属性也适用于自动文档馈送器，这些自动文档馈送器无需将工作表移动到平板扫描仪的平板上。 对于工作表送纸、滚动式扫描仪和手持扫描仪，此属性是必需的。

类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE
WIA_DPS_MAX_SCAN_TIME
ScannerDeviceMaxScanTime

包含使用当前属性设置扫描单个页面的最长时间（以毫秒为单位）。 应用程序读取此属性以估计扫描页面所需的时间。 这在确定已停止响应的设备的条件时非常有用。 微型驱动程序创建和维护此属性。 此属性是所有扫描程序所必需的。

类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE
WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceMinHorizontalSheetFeedSize

注意：
Windows Vista 及更高版本不支持此属性。 使用 WIA_IPS_MIN_HORIZONTAL_SIZE。

 

包含扫描仪的文档馈送器可以扫描的最小页面的物理水平尺寸（以千分之一英寸为单位）。 微型驱动程序创建和维护此属性。

类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE

另请参阅

WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE
WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceMinVerticalSheetFeedSize

注意：
Windows Vista 及更高版本不支持此属性。 使用 WIA_IPS_MIN_VERTICAL_SIZE。

 

包含扫描仪的文档馈送器可以扫描的最小页面的物理垂直尺寸（以千分之一英寸为单位）。 微型驱动程序创建和维护此属性。

类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE

另请参阅

WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE
WIA_DPS_OPTICAL_XRES
ScannerDeviceOpticalXres

注意：
Windows Vista 不支持此属性。 使用 WIA_IPS_OPTICAL_XRES。

 

水平光学分辨率。 支持的最高水平光学分辨率（以 DPI 为单位）。 此属性是单个值。 这不是设备可以生成的所有分辨率的列表。 相反，这是设备的光学分辨率。 微型驱动程序创建和维护此属性。 此属性是所有扫描程序所必需的。

类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE
WIA_DPS_OPTICAL_YRES
ScannerDeviceOpticalYres

注意：
Windows Vista 不支持此属性。 使用 WIA_IPS_OPTICAL_YRES。

 

垂直光学分辨率。 支持的最高垂直光学分辨率（以 DPI 为单位）。 此属性是单个值。 这不是设备生成的所有分辨率的列表。 相反，这是设备的光学分辨率。 微型驱动程序创建和维护此属性。 此属性是所有扫描程序所必需的。

类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE
WIA_DPS_ORIENTATION
ScannerDeviceOrientation

包含当前方向设置。微型驱动程序创建和维护此属性。

应用程序设置 WIA_DPS_ORIENTATION 属性以定义要获取的页面或图像的原始方向。 有关如何使用WIA_DPS_ORIENTATION的信息，请参阅 WIA_DPS_PAGE_SIZE

类型： VT_I4，访问：读/写，有效值： WIA_PROP_LIST

下表包含对此属性有效的四个常量。

值 定义
LANDSCAPE 相对于 PORTRAIT 方向的逆时针旋转 90 度。
肖像 0 度。
ROT180 相对于 PORTRAIT 方向的逆时针旋转 180 度。
ROT270 相对于 PORTRAIT 方向的逆时针旋转 270 度。

 

另请参阅

WIA_IPS_ROTATION
WIA_DPS_PAD_COLOR
ScannerDevicePadColor

当没有足够的图像数据来填充请求的缓冲区时，用于填充的颜色。 此属性是针对填充缓冲区的扫描仪实现的。 此属性对于所有扫描程序都是可选的。 微型驱动程序创建和维护此属性。

类型： VT_UI1 | VT_VECTOR、Access：只读、有效值： WIA_PROP_NONE

颜色信息的格式为 RGBQUAD。
WIA_DPS_PAGE_HEIGHT
ScannerDevicePageHeight

注意：
Windows Vista 不支持此属性。 使用 WIA_IPS_PAGE_HEIGHT。

 

包含当前所选页面的高度（以千分之一英寸为单位）。 微型驱动程序创建和维护 WIA_DPS_PAGE_HEIGHT 属性。 应用程序读取此属性以确定要扫描的页面的物理尺寸。 如果盘区设置不同于已知的页面大小，则此属性报告其 WIA_DPS_PAGE_SIZE 属性设置为WIA_PAGE_CUSTOM () WIA_DPS_PAGE_SIZE 属性的值的页面的高度。 WIA_DPS_PAGE_HEIGHT 必须与 WIA_IPS_XEXTENT同步，WIA_IPS_XEXTENT报告要扫描的页面的高度（以像素为单位）。

类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE
WIA_DPS_PAGE_SIZE
ScannerDevicePageSize

注意：
Windows Vista 不支持此属性。 使用 WIA_IPS_PAGE_SIZE。

 

包含当前选择要扫描的页面的大小。 若要选择要扫描的页面的尺寸，应用程序会设置此属性。 微型驱动程序创建和维护此属性。

类型： VT_I4，访问：读/写，有效值： WIA_PROP_LIST

下表包含对此属性有效的三个常量。

值 定义
WIA_PAGE_A4 8267 X 11692 (纵向)
WIA_PAGE_CUSTOM 由 WIA_DPS_PAGE_HEIGHT 和 WIA_DPS_PAGE_WIDTH 属性的值定义
WIA_PAGE_LETTER 8500 X 11000 (纵向)

 

WIA_IPS_ORIENTATION 属性的值确定当前所选页面的方向。 WIA_DPS_PAGE_WIDTH和WIA_DPS_PAGE_HEIGHT属性报告页面的尺寸（以千分之一英寸为单位）。 请注意，这些属性必须与包含页面尺寸（以像素为单位） 的WIA_IPS_XEXTENT 和 WIA_IPS_YEXTENT一致。 WIA_PROP_LIST类型的有效值应取决于 WIA_IPS_ORIENTATION 属性的有效设置。 如果设备无法使用WIA_PAGE_A4设置扫描面向横向的文档，则当WIA_IPS_ORIENTATION设置为 LANSCAPE 时，不应在 WIA_DPS_PAGE_SIZE 属性的有效值列表中显示 WIA_PAGE_A4 。

如果应用程序 将WIA_DPS_PAGE_SIZE 设置为除WIA_PAGE_CUSTOM以外的任何值，微型驱动程序应调整 WIA_DPS_PAGE_WIDTH 的值，并将 WIA_DPS_PAGE_HEIGHT 到页面尺寸（千分之一英寸）。 它还应调整 WIA_IPS_XEXTENT 的值，并将 WIA_IPS_YEXTENT 的值调整为页面的尺寸（以像素为单位）。

如果 (WIA_IPS_XEXTENT 或 WIA_IPS_YEXTENT) 的范围设置更改为与当前页大小设置不匹配的值，微型驱动程序应将 WIA_DPS_PAGE_SIZE 属性的值更改为WIA_PAGE_CUSTOM。 微型驱动程序还应根据新的盘区设置修改 WIA_DPS_PAGE_WIDTH 或 WIA_DPS_PAGE_HEIGHT 。

如果 WIA_IPS_ORIENTATION 设置为 LANSCAPE，则盘区设置将“翻转”。例如，如果应用程序将 WIA_DPS_PAGE_SIZE 设置为 WIA_PAGE_A4，微型驱动程序应将 WIA_DPS_PAGE_WIDTH 设置为 11692， WIA_DPS_PAGE_HEIGHT 设置为 8267。 (微型驱动程序还应设置 WIA_IPS_XEXTENT 并相应地 WIA_IPS_YEXTENT 。) 请注意，如果将 WIA_DPS_PAGE_SIZE 设置为WIA_PAGE_CUSTOM，则方向设置不用于确定要扫描的页面的范围尺寸。

微型驱动程序负责确保 WIA_IPS_ORIENTATION 属性与当前选择区域一致。 如果应用程序将 WIA_IPS_ORIENTATION 的值更改为当前所选页面大小无效的值，则微型驱动程序应将 WIA_DPS_PAGE_SIZE 的值更改为新方向值支持的页面大小。

如果应用程序将 WIA_DPS_PAGE_SIZE 属性设置为 WIA_PAGE_CUSTOM，则当前选择区域不受影响。 WIA 微型驱动程序应从 WIA_IPS_XPOS 和 WIA_IPS_YPOS 属性的当前设置开始获取当前图像布局。 如果页面大小设置导致选择区域位于扫描仪的床外，微型驱动程序必须自动调整 WIA_IPS_XPOS 的值，并将属性 WIA_IPS_YPOS 为有效设置。 如果 同时设置WIA_DPS_PAGE_SIZE 和 WIA_IPS_ORIENTATION 属性，并且这些属性在组合应用时无效，则微型驱动程序应在 IWiaMiniDrv：:d rvValidateItemProperties 中返回错误，从而使应用程序的设置失败。 .

以下四个示例演示了不同的 WIA_DPS_PAGE_SIZE 方案。

  1. 驱动程序报告设置。
  2. 应用程序将 WIA_DPS_PAGE_SIZE 属性设置为 WIA_PAGE_LETTER。
  3. 应用程序将 WIA_IPS_ORIENTATION 属性设置为 LANSCAPE。
  4. 应用程序将 WIA_IPS_XEXTENT 属性更改为较小的值。

示例 1：微型驱动程序报告设置

在以下示例中，微型驱动程序在应用程序设置任何 WIA 属性之前设置自定义选择区域。 在本例中，选择区域表示整个平板。

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_WIDTH = 11500
WIA_DPS_PAGE_HEIGHT = 14000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1150
WIA_IPS_YEXTENT = 1400
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

示例 2：应用程序将WIA_DPS_PAGE_SIZE属性设置为 WIA_PAGE_LETTER

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_WIDTH = 8500
WIA_DPS_PAGE_HEIGHT = 11000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 850
WIA_IPS_YEXTENT = 1100
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

示例 3：应用程序将WIA_IPS_ORIENTATION属性设置为 LANSCAPE

物理床必须能够获取最初处于横向方向的页面。

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_HEIGHT = 11000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1100
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

示例 4：应用程序将WIA_IPS_XEXTENT属性更改为较小的值

在以下示例中，应用程序将 WIA_IPS_XEXTENT 属性更改为 1000。 微型驱动程序应假定 WIA_IPS_XEXTENT 中包含的新值对 WIA_DPS_PAGE_SIZE 属性不再有效，因此应 将WIA_DPS_PAGE_SIZE 更改为WIA_PAGE_CUSTOM。 微型驱动程序还必须调整 WIA_DPS_PAGE_WIDTH。

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_HEIGHT = 10000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1000
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100
WIA_DPS_PAGE_WIDTH
ScannerDevicePageWidth

注意：
Windows Vista 不支持此属性。 使用 WIA_IPS_PAGE_WIDTH。

 

包含所选当前页的宽度（以千分之一英寸为单位）。 应用程序读取此属性以确定要扫描的页面的物理尺寸。 如果盘区设置与已知页面大小不同，则此属性报告其 WIA_DPS_PAGE_SIZE 属性设置为WIA_PAGE_CUSTOM的页面的宽度。 WIA_DPS_PAGE_WIDTH 必须与 WIA_IPS_XEXTENT 的值同步，该值报告要扫描的页面的宽度（以像素为单位）。 微型驱动程序创建和维护此属性。

类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE
WIA_DPS_PAGES
ScannerDevicePages

注意：
Windows Vista 不支持此属性。 使用 WIA_IPS_PAGES。

 

包含要从自动文档馈送器获取的当前页数。 微型驱动程序创建和维护此属性。

类型： VT_I4;访问：读/写;有效值： WIA_PROP_RANGE (零到文档馈送器可以容纳的最大页数)

应用程序读取此属性以确定文档馈送器的页面容量。 应用程序还会将此属性设置为要扫描的页数。

注意：
如果启用了双工模式 (WIA_DPS_DOCUMENT_HANDLING_SELECT 设置为 FEEDER |双工 ) ， WIA_DPS_PAGES 仍等于要扫描的页数。

 

如果启用了 DUPLEX，一张纸将自动包含两页，即使页面的背面为空白。

将 WIA_DPS_PAGES 设置为 1 会导致扫描程序处理页面的一侧。 建议如果扫描程序在双工模式下无法仅扫描页面的一侧，则应将 WIA_PROPERTY_INFO 结构的 Inc 成员 WIA_DPS_PAGES 有效值更改为 2。 此值向应用程序发出信号，它必须请求两个倍数中的页。 值为零意味着将扫描当前加载到文档馈送器 中的所有 页面。
WIA_DPS_PLATEN_COLOR
ScannerDevicePlatenColor

指定要扫描的工作表背面的板的颜色。 对于具有板的扫描仪，此属性是可选的。 微型驱动程序创建和维护此属性。

类型： VT_UI1 | VT_VECTOR、Access：只读、有效值： WIA_PROP_NONE

颜色信息的格式为 RGBQUAD。
WIA_DPS_PREVIEW
ScannerDevicePreview

注意：
Windows Vista 不支持此属性。 使用 WIA_IPS_PREVIEW。

 

指示设备的预览模式。 应用程序将此属性设置为将设备置于预览模式。

类型： VT_I4，访问：读/写，有效值： WIA_PROP_LIST

下表包含对此属性有效的两个常量。

值 定义
WIA_FINAL_SCAN 应用程序将执行最终扫描。
WIA_PREVIEW_SCAN 应用程序将执行预览扫描。

 
WIA_DPS_SCAN_AHEAD_PAGES
ScannerDeviceScanAheadPages

包含一个值，该值指示扫描程序是否在将页面发送到应用程序之前缓存扫描程序缓冲区中的页面。

值为零会禁用提前扫描，并且不会提前扫描任何页面。 对缓冲的提前扫描项执行正常的数据传输会检索缓冲页。 在提前扫描操作期间，无法更改 WIA 属性。 此属性是可选的。

类型： VT_I4、Access：读/写、有效值： WIA_PROP_RANGE 0 到文档馈送器可以容纳的最大页数。
WIA_DPS_SCAN_AVAILABLE_ITEM
ScannerDeviceScanAvailableItem

注意：
仅 Windows 7 及更高版本支持此属性。

 

指示输入源 (平板、自动文档馈送器或 fil 扫描适配器) 扫描，或从中传输数据的存储位置。

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

类型： VT_I4、Access：读/写、有效值： WIA_PROP_RANGE 0 到文档馈送器可以容纳的最大页数。
WIA_DPS_SERVICE_ID
ScannerDeviceServiceId

注意：
此属性仅受 Windows Vista 及更高版本的支持。

 

包含 Web 服务扫描程序设备的服务 ID。 WIA 2.0 微型驱动程序创建和维护此属性。

类型： VT_BSTR，访问：只读，有效值： WIA_PROP_NONE
WIA_DPS_SHEET_FEEDER_REGISTRATION
ScannerDeviceSheetFeederRegistration

注意：
Windows Vista 及更高版本不支持此属性。 使用 WIA_IPS_SHEET_FEEDER_REGISTRATION。

 

包含放置在平板上的文档的注册或对齐和边缘检测。 微型驱动程序创建和维护此属性。 此属性指示工作表如何水平放置于手持扫描仪或工作表送纸扫描仪的扫描头上。 属性用于预测文档在扫描头上的放置位置。

对于支持多个扫描头的扫描仪，此属性相对于最顶部的扫描头。 对于工作表送纸、滚动式扫描仪和手持扫描仪，此属性是必需的。

类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE

下表包含对此属性有效的三个常量。

一直 说明
LEFT_JUSTIFIED 工作表相对于扫描头向左放置。
中心 工作表以扫描头为中心。
RIGHT_JUSTIFIED 工作表相对于扫描头向右放置。

 
WIA_DPS_SHOW_PREVIEW_CONTROL
ScannerDeviceShowPreviewControl

注意：
Windows Vista 不支持此属性。 使用 WIA_IPS_SHOW_PREVIEW_CONTROL。

 

指示项是否需要向用户显示的预览控件。 微型驱动程序创建和维护此属性。

类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE

下表包含对此属性有效的两个常量。

一直 说明
WIA_SHOW_PREVIEW_CONTROL 向用户显示预览控件，因为此设备可以执行预览。
WIA_DONT_SHOW_PREVIEW_CONTROL 不要向用户显示预览控件，因为此设备无法执行预览。

 
WIA_DPS_USER_NAME
ScannerDeviceUserName

注意：
此属性仅受 Windows Vista 及更高版本的支持。

 

由 WIA 服务用于通知微型驱动程序有关用户帐户名称 (包括网络域名（如果适用）) 运行当前 WIA 应用程序的会话。

这是一个根项属性，由 WIA 服务管理。

类型： VT_BSTR，访问：只读，有效值： WIA_PROP_NONE
WIA_DPS_VERTICAL_BED_REGISTRATION
ScannerDeviceVerticalBedRegistration

注意：
Windows Vista 及更高版本不支持此属性。

 

包含放置于平板上的文档的注册或垂直对齐和边缘检测。 微型驱动程序创建和维护此属性。

类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE

下表包含对此属性有效的三个常量。

一直 说明
TOP_JUSTIFIED 该论文最合理。
中心 纸张居中。
BOTTOM_JUSTIFIED 纸张底端对齐。

 

另请参阅。

WIA_DPS_HORIZONTAL_BED_REGISTRATION
WIA_DPS_VERTICAL_BED_SIZE
ScannerDeviceVerticalBedSize

注意：
Windows Vista 及更高版本不支持此属性。 使用 WIA_IPS_MAX_VERTICAL_SIZE。

 

指定在垂直 (Y) 轴上以当前分辨率从平板扫描仪的板中扫描的最大高度（以千分之一英寸为单位）。 此属性也适用于自动文档送纸器，用于将工作表移动到平板扫描仪的印版进行扫描。 此属性对于具有印版的扫描仪是必需的。 其他扫描程序类型将改为实现 WIA_DPS_VERTICAL_SHEET_FEED_SIZE 属性。

类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE
WIA_DPS_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceVerticalSheetFeedSize

注意：
Windows Vista 及更高版本不支持此属性。 使用 WIA_IPS_MAX_VERTICAL_SIZE。

 

指定在垂直 (Y) 轴上以当前分辨率从手持或纸张进纸扫描仪扫描的最大高度（以千分之一英寸为单位）。 此属性也适用于自动文档送纸器，这些送纸器无需将工作表移动到平板扫描仪的印版上。 对于工作表送纸扫描仪，此属性是必需的。 滚动式扫描仪和手持扫描仪不应实现此属性。

类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE

要求

要求 值
最低受支持的客户端
 Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器
 Windows Server 2003 [仅限桌面应用]
标头
Wiadef.h