扫描程序 WIA 项属性常量

项目
09/03/2023

以下常量指定 Windows 映像采集 (WIA) 扫描程序项属性的有效集。

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

常量/值说明

WIA_IPS_AUTO_DESKEW
ScannerPictureAutoDeskew

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

打开或关闭自动倾斜。
可选，仅适用于 WIA_CATEGORY_FEEDER。
类型： VT_I4，访问：读/写，有效值： WIA_PROP_LIST
下表包含对此属性有效的常量。

一直	说明
WIA_AUTO_DESKEW_ON	打开自动反转。
WIA_AUTO_DESKEW_OFF	关闭自动对等。

WIA_IPS_BRIGHTNESS
ScannerPictureBrightness

扫描仪中可用的图像亮度值。

包含设备的当前硬件亮度设置。应用程序将此属性设置为硬件的亮度值。微型驱动程序创建和维护此属性。

值应映射在 -1000 到 1000 的范围内，其中 1000 表示最大亮度，0 表示正常亮度，-1000 表示最小亮度。

类别中的所有项都是必需的：WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK和WIA_CATEGORY_FILM。可选，但建议用于支持预览的WIA_CATEGORY_FINISHED_FILE项。

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

WIA_IPS_CONTRAST
ScannerPictureContrast

包含设备的当前硬件对比度设置。应用程序将此属性设置为硬件的对比度值。微型驱动程序创建和维护此属性。

值应在 -1000 到 1000 的范围内映射，其中 -1000 对应于最小对比度，0 对应于正常对比度，1000 对应于最大对比度。

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

WIA_IPS_CUR_INTENT
ScannerPictureCurIntent

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

对于所有启用购置的项是必需的;即类别中的项：WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK和WIA_CATEGORY_FILM。 WIA_CATEGORY_FINISHED_FILE或WIA_CATEGORY_FOLDER项不支持它。

类型： VT_I4 访问权限：读/写，有效值： WIA_PROP_FLAGS

驱动程序使用这些属性根据应用程序对图像的预期用途来预设项属性。例如，这可能包括最大质量、最小大小等。

驱动程序选择位深度（以每英寸点为单位）以及它确定适合所选意向的其他设置。由应用程序来读取当前设置以确定哪些属性已更改。应用程序将此属性设置为自动设置特定获取意向的 WIA 属性。此属性是所有扫描仪所必需的。

应用程序将此属性设置为自动设置特定获取意向的 WIA 属性

注意：
标志可以与按位 OR 运算符结合使用，但图像不能同时为灰度和彩色。

此属性是所有扫描仪所必需的。

下表包含图像类型标志及其定义。这些标志用于设置预期的图像类型：颜色、灰度等。

预期映像类型标志	说明
WIA_INTENT_NONE	默认值。未指定意向。
WIA_INTENT_IMAGE_TYPE_COLOR	应用程序打算准备设备进行颜色扫描。
WIA_INTENT_IMAGE_TYPE_GRAYSCALE	应用程序打算准备设备进行灰度扫描。
WIA_INTENT_IMAGE_TYPE_TEXT	应用程序打算准备设备以扫描文本。
WIA_INTENT_IMAGE_TYPE_MASK	所有图像类型标志的掩码。

下表包含质量和大小标志及其定义。这些标志用于设置预期的质量级别。

预期图像大小/质量标志	说明
WIA_INTENT_MINIMIZE_SIZE	应用程序打算准备设备以扫描导致小扫描的图像。
WIA_INTENT_MAXIMIZE_QUALITY	应用程序打算准备设备以扫描高质量图像。
WIA_INTENT_SIZE_MASK	此标志是所有大小/质量标志的掩码。
WIA_INTENT_BEST_PREVIEW	应用程序打算准备设备以扫描预览版。

WIA_IPS_DESKEW_X
ScannerPictureDeskewX

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

包含从WIA_IPS_XPOS到要对等的图像最上角的 x 坐标的 x 方向的像素数。因此，它与WIA_IPS_DESKEW_Y一起描述倾斜图像的两个左上角位于WIA_IPS_XPOS、WIA_IPS_YPOS、WIA_IPS_XEXTENT和WIA_IPS_YEXTENT定义的边框内。如果扫描程序驱动程序支持对等，则其属性由该驱动程序实现。

WIA_IPS_DESKEW_X的有效值必须介于 0 和 (WIA_IPS_XEXTENT - 1) 之间。如果值为 0，则表示不应执行任何向后操作。

对于类别WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER和WIA_CATEGORY_FILM的项，此属性是可选的;它不适用于WIA_CATEGORY_FINISHED_FILE或WIA_CATEGORY_FOLDER项。

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

WIA_IPS_DESKEW_Y
ScannerPictureDeskewY

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

包含从WIA_IPS_YPOS到要倾斜的图像最左侧角的 y 坐标的 y 方向的像素数。因此，它与WIA_IPS_DESKEW_X一起描述了倾斜图像的两个上角位于WIA_IPS_XPOS、WIA_IPS_YPOS、WIA_IPS_XEXTENT和WIA_IPS_YEXTENT定义的边框内。如果扫描程序驱动程序支持对等，则此属性由它实现。

WIA_IPS_DESKEW_Y的有效值必须介于 0 到 (WIA_IPS_YEXTENT - 1) 之间。如果值为 0，则表示不应执行任何偏差。

对于WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER和WIA_CATEGORY_FILM类别的项，此属性是可选的;它不适用于WIA_CATEGORY_FINISHED_FILE或WIA_CATEGORY_FOLDER项。

类型： VT_I4，Access：读/写，有效值：WIA_PROP_RANGE

WIA_IPS_DOCUMENT_HANDLING_SELECT
ScannerPictureDocumentHandlingSelect

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

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

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

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

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

Flags	说明
双工	使用双工器操作进行扫描。使用为馈送器项 (WIA_CATEGORY_FEEDER) 配置的常见设置扫描两个文档面。不能同时设置双工和ADVANCE_DUPLEX。
ADVANCED_DUPLEX	使用为每个子馈送器项配置的各个设置进行扫描 (WIA_CATEGORY_FEEDER_FRONT 和WIA_CATEGORY_FEEDER_BACK) 。不能同时设置双工和ADVANCE_DUPLEX。
FRONT_FIRST	首先扫描文档的前面。此值在设置 DUPLEX 或 ADVANCED_DUPLEX 时有效。
BACK_FIRST	首先扫描文档的背面。此值在设置 DUPLEX 或 ADVANCED_DUPLEX 时有效。
FRONT_ONLY	仅扫描正面。
BACK_ONLY	仅扫描背面。此值在设置 DUPLEX 或 ADVANCED_DUPLEX 时有效。

WIA_IPS_FILM_NODE_NAME
ScannerPictureFilmNodeName

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

当有多个时，启用特定胶片扫描附件的规范。

当有多个胶片扫描项时，WIA_CATEGORY_FILM项需要此属性。如果设备仅支持一个根扫描仪胶卷项，则此属性是可选的。

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

允许的值：BSTR 应采用 @ResourceBinary，-<ResourceID> 格式，以允许本地化，因为此字符串将通过胶片扫描 UI 向用户公开。

WIA_IPS_FILM_SCAN_MODE
ScannerPictureFilmScanMode

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

启用当前胶片扫描的配置。

此属性是WIA_CATEGORY_FILM项所必需的。

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

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

一直	说明
WIA_FILM_COLOR_SLIDE	扫描彩色幻灯片。
WIA_FILM_COLOR_NEGATIVE	扫描底色。
WIA_FILM_BW_NEGATIVE	扫描黑白负。

WIA_IPS_INVERT
ScannerPictureInvert

保留供将来使用，目前未实现。

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

WIA_IPA_ITEMS_STORED
ScannerPictureInvert

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

指定WIA_CATEGORY_FOLDER项中存储的项数。

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

WIA_IPS_LAMP
ScannerPictureLamp

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

打开或关闭扫描仪灯。

对于WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER和WIA_CATEGORY_FILM项是可选的，建议用于WIA_CATEGORY_FILM。

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

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

一直	说明
WIA_LAMP_ON	打开灯。
WIA_LAMP_OFF	关掉灯。

WIA_IPS_LAMP_AUTO_OFF
ScannerPictureLampAutoOff

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

设置未使用扫描仪时保持灯亮起的最长时间。

对于WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER和WIA_CATEGORY_FILM项是可选的，建议用于WIA_CATEGORY_FILM。

类型： VT_UI4，访问：读/写，有效值：0 - 0xFFF秒

WIA_IPS_MAX_HORIZONTAL_SIZE
ScannerPictureMaxHorizontalSize

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

指定当前分辨率的水平 (X) 轴扫描的最大宽度（以千分之一英寸为单位）。根据项目类型，这可能是纸张进纸器或扫描床的宽度。

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

WIA_IPS_MAX_VERTICAL_SIZE
ScannerPictureMaxVerticalSize

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

指定在当前分辨率的垂直 (Y) 轴上扫描的最大高度（以千分之一英寸为单位）。根据项目类型，这可能是纸张送纸器或扫描床的高度。

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

WIA_IPS_MIN_HORIZONTAL_SIZE
ScannerPictureMinHorizontalSize

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

指定在当前分辨率下水平 (X) 轴上扫描的最小宽度（千分之一英寸）。

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

WIA_IPS_MIN_VERTICAL_SIZE
ScannerPictureMinVerticalSize

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

指定在当前分辨率的垂直 (Y) 轴上扫描的最小高度（以千分之一英寸为单位）。

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

WIA_IPS_MIRROR
ScannerPictureMirror

保留供将来使用，目前未实现。

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

WIA_IPS_OPTICAL_XRES
ScannerPictureOpticalXres

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

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

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

WIA_IPS_OPTICAL_YRES
ScannerPictureOpticalYres

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

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

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

WIA_IPS_ORIENTATION
ScannerPictureOrientation

指定要扫描的文档的当前方向。微型驱动程序创建和维护此属性。

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

注意：
WIA_IPS_ORIENTATION是指要扫描的文档在扫描仪床或送纸器上的位置。它是文档相对于扫描方向的方向。 WIA_IPS_ROTATION是指在扫描图像后（就在图像传输到应用程序之前）应用于图像的旋转。

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

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

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

WIA_IPS_PAGE_SIZE
ScannerPicturePageSize

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

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

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

有关可与此属性一起使用的常量，请参阅 WIA 2.0 页面大小常量。请注意这些非固定大小，特别是：

值	定义
WIA_PAGE_CUSTOM	由 WIA_IPS_PAGE_HEIGHT 和 WIA_IPS_PAGE_WIDTH 属性的值定义。
WIA_PAGE_AUTO	页面大小由设备自动确定。
WIA_PAGE_CUSTOM_BASE	一个自定义页面大小，其尺寸已为应用程序和设备驱动程序所知。

WIA_IPS_ORIENTATION 属性的值确定当前所选页面的方向。 WIA_IPS_PAGE_WIDTH和WIA_IPS_PAGE_HEIGHT属性以千分之一英寸为单位报告页面的尺寸。这些属性必须与包含页面尺寸（以像素为单位） WIA_IPS_XEXTENT 和 WIA_IPS_YEXTENT一致。

注意：
类型WIA_PROP_LIST的有效值取决于 WIA_IPS_ORIENTATION 属性的有效设置。例如，如果设备无法使用WIA_PAGE_A4设置扫描面向横向的文档，则当WIA_IPS_ORIENTATION设置为 LANDSCAPE 时，WIA_PAGE_A4不是 WIA_IPS_PAGE_SIZE 属性的有效值。

如果应用程序将 WIA_IPS_PAGE_SIZE 设置为上表中除三个值以外的任何值，微型驱动程序应调整 WIA_IPS_PAGE_WIDTH 的值，并将 WIA_IPS_PAGE_HEIGHT 页面尺寸（千分之一英寸）。它还应调整 WIA_IPS_XEXTENT 的值， 并将WIA_IPS_YEXTENT 的值调整为页面的尺寸（以像素为单位）。

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

如果 WIA_IPS_ORIENTATION 设置为 LANDSCAPE，则盘区设置将相对于其通常值交换。例如，如果应用程序将 WIA_IPS_PAGE_SIZE 设置为 WIA_PAGE_A4，微型驱动程序会将 WIA_IPS_PAGE_WIDTH 设置为 11692， WIA_IPS_PAGE_HEIGHT 设置为 8267。 (微型驱动程序还应调整 WIA_IPS_XEXTENT 并相应地 WIA_IPS_YEXTENT 。)

注意：
如果 WIA_IPS_PAGE_SIZE 设置为WIA_PAGE_CUSTOM，则方向设置不用于确定要扫描的页面的盘区尺寸。

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

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

以下四个示例显示了不同的 WIA_IPS_PAGE_SIZE 方案。

驱动程序报告设置。
应用程序将 WIA_IPS_PAGE_SIZE 属性设置为WIA_PAGE_LETTER。
应用程序将 WIA_IPS_ORIENTATION 属性设置为 LANDSCAPE。
应用程序将 WIA_IPS_XEXTENT 属性更改为较小的值。

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

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

WIA_IPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_IPS_PAGE_WIDTH = 11500
WIA_IPS_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_IPS_PAGE_SIZE属性设置为WIA_PAGE_LETTER

WIA_IPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_IPS_PAGE_WIDTH = 8500
WIA_IPS_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属性设置为 LANDSCAPE

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

WIA_IPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_IPS_PAGE_HEIGHT = 11000
WIA_IPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANDSCAPE
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_IPS_PAGE_SIZE 属性不再有效，因此应 WIA_IPS_PAGE_SIZE 更改为WIA_PAGE_CUSTOM。微型驱动程序还必须调整 WIA_IPS_PAGE_WIDTH。

WIA_IPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_IPS_PAGE_HEIGHT = 10000
WIA_IPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANDSCAPE
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_IPS_PAGE_HEIGHT
ScannerPicturePageHeight

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

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

此属性是WIA_CATEGORY_FEEDER项所必需的。

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

WIA_IPS_PAGE_WIDTH
ScannerPicturePageWidth

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

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

此属性是WIA_CATEGORY_FEEDER项所必需的。

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

WIA_IPS_PAGES
ScannerPicturePages

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

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

类型： VT_I4;访问：读/写;有效值： WIA_PROP_RANGE 扫描程序可以扫描的最大页数为零。如果扫描程序可以连续扫描，则值为 ALL_PAGES (= 0) 。

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

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

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

将 WIA_IPS_PAGES 设置为 1 会导致扫描程序处理页面的一侧。我们建议，如果扫描程序在双工模式下无法仅扫描页面的一侧，请将WIA_PROPERTY_INFO结构的 Range 成员的 Inc 成员的 WIA_IPS_PAGES 值更改为 2。此值指示应用程序必须请求 2 的倍数中的页。值 ALL_PAGES (= 0) 表示将扫描当前加载到文档送纸器 中的所有 页面。

WIA_IPS_PHOTOMETRIC_INTERP
ScannerPicturePhotometricInterp

包含白色和黑色像素的当前设置。微型驱动程序创建和维护此属性。

应用程序读取此值以确定 WHITE 或 BLACK (的值，具体取决于应用程序) 执行的操作。

对于所有启用或存储的购置项是必需的;即类别中的项：WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK、WIA_CATEGORY_FINISHED_FILE和WIA_CATEGORY_FILM。不支持WIA_CATEGORY_FOLDER项。

类型： VT_I4;访问：读/写;有效值： WIA_PROP_LIST。如果设备只能设置为单个值，请创建一个WIA_PROP_LIST类型，并在其中放置有效值。

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

值	定义
WIA_PHOTO_WHITE_0	WHITE 为 0，BLACK 为 1。
WIA_PHOTO_WHITE_1	WHITE 为 1，BLACK 为 0。

WIA_IPS_PREVIEW
ScannerPicturePreview

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

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

此属性是WIA_CATEGORY_FLATBED项和WIA_CATEGORY_FILM项所必需的，对于WIA_CATEGORY_FEEDER项是可选的。

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

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

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

WIA_IPS_PREVIEW_TYPE
ScannerPicturePreviewType

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

指定是否可以在图像预览 (期间更新现有预览图像，以响应WIA_IPA_DATATYPE或) WIA_IPA_DEPTH属性的更改。

对于支持预览扫描的所有启用购置的项，此属性是可选的;也就是说，WIA_PREVIEW_SCAN支持WIA_IPS_PREVIEW。这包括WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK和WIA_CATEGORY_FILM类型的项。

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

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

一直	说明
WIA_ADVANCED_PREVIEW	可以更新现有映像。
WIA_BASIC_PREVIEW	必须执行另一个预览扫描，因为无法更新现有图像。

WIA_IPS_ROTATION
ScannerPictureRotation

包含当前旋转设置（如果已实现）。微型驱动程序创建和维护此属性。

应用程序设置此属性以通知驱动程序在驱动程序将映像返回到应用程序之前，如果) 旋转映像，则 (多少。

WIA 微型驱动程序负责在将图像数据发送回应用程序之前旋转图像数据。应用程序负责检查图像标头以查看新轮换的值。

解决旋转对当前图像选择区域的影响 () WIA_IPS_XPOS、WIA_IPS_YPOS、WIA_IPS_XEXTENT和WIA_IPS_YEXTENT属性定义时，存在相当大的混淆。

选择区域 是指从中获取图像的物理扫描仪床上的选定区域。 WIA_IPS_ROTATION 不修改选择区域。只有在驱动程序获取了相应的选择区域后，驱动程序才根据 WIA_IPS_ROTATION 应用逆时针旋转。 WIA_IPS_ROTATION 确实会影响输出图像的尺寸，因此这些维度必须反映在生成的图像的数据标头中。

对于所有启用购置的项，可选;即类别中的项：WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK和WIA_CATEGORY_FILM。

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

定义了以下旋转常量。

常数	定义
肖像	驱动程序不会旋转图像。
LANDSCAPE	T 驱动程序逆时针旋转图像 90 度。
ROT180	驱动程序逆时针旋转图像 180 度。
ROT270	驱动程序逆时针旋转图像 270 度。

WIA_IPS_SEGMENTATION
ScannerPictureSegmentation

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

指定应用程序是否应使用驱动程序的分段筛选器进行多区域扫描。如果WIA_CATEGORY_FLATBED和WIA_CATEGORY_FILM项支持使用分段筛选器创建子项，或者驱动程序本身为固定帧创建子项，则必须为这些项实现WIA_IPS_SEGMENTATION。

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

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

值	定义
WIA_USE_SEGMENTATION_FILTER	应用程序应使用分段筛选器进行多区域扫描。
WIA_DONT_USE_SEGMENTATION_FILTER	驱动程序创建子项本身用于多区域扫描。如果扫描程序出于此目的使用固定帧，则通常就是这种情况。

注意：
驱动程序可能附带分段筛选器，但仍将WIA_IPS_SEGMENTATION设置为WIA_DONT_USE_SEGMENTATION_FILTER其某个项 (例如，WIA_CATEGORY_FILM项) 。如果扫描仪使用固定帧进行胶片扫描，但不适用于从WIA_CATEGORY_FLATBED项进行常规扫描的情况。

WIA_IPS_SHEET_FEEDER_REGISTRATION
ScannerPictureSheetFeederRegistration

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

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

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

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

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

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

WIA_IPS_SHOW_PREVIEW_CONTROL
ScannerPictureShowPreviewControl

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

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

对于所有已启用传输的项，可选。这通常只是WIA_ITEM_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FILM和WIA_CATEGORY_FINISHED_FILE类别的项。

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

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

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

WIA_IPS_SUPPORTS_CHILD_ITEM_CREATION
ScannerPictureSupportsChildItemCreation

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

指定应用程序 (还是筛选器) 可以在当前项下创建子项。

对于所有已启用传输的项类别（可选）：WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FILM甚至WIA_CATEGORY_FOLDER。 (如果存储不支持上传新项目，则此属性应不受支持或受 FALSE 值支持。)

支持WIA_IPS_SEGMENTATION和WIA_USE_SEGMENTATION_FILTER的项还必须支持WIA_IPS_SUPPORTS_CHILD_ITEM_CREATION，并将其设置为 TRUE。

类型： VT_I4，访问：只读，有效值： TRUE 和 FALSE

WIA_IPS_THRESHOLD
ScannerPictureThreshold

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

指定灰度值，该值确定将图像转换为单色时像素是转换为白色还是黑色。超出阈值的像素变为白色。低于阈值的像素变为白色。

对于支持 1 bpp 扫描且将 WIA_IPA_DATATYPE 属性设置为 WIA_DATA_THRESHOLD 的购置项，此属性是必需的。

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

WIA_IPS_TRANSFER_CAPABILITIES
ScannerPictureTransferCapabilities

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

指定驱动程序是否能够在单个传输调用中传输多个子项。

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

此属性的唯一可能值是WIA_TRANSFER_CHILDREN_SINGLE_SCAN。如果设置了此标志，则驱动程序能够在单个传输调用中传输多个子项。如果未设置标志，WIA 服务将以递归方式遍历子项，然后传输其中每个项。

WIA_IPA_UPLOAD_ITEM_SIZE
ScannerPictureInvert

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

指定要为项上传的字节数。

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

WIA_IPS_WARM_UP_TIME
ScannerPictureWarmUpTime

指定设备在开始扫描操作之前所需的最大预热时间（以毫秒为单位）。微型驱动程序创建和维护此属性。

应用程序可以读取此属性以确定此设备的最大预热时间。然后，它可以显示“等待设备预热”对话框，让用户知道在发生任何操作之前可能会发生等待或暂停。

此属性是所有启用购置的项所必需的;即类别中的项：WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK和WIA_CATEGORY_FILM。

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

WIA_IPS_XEXTENT
ScannerPictureXextent

包含要获取的选定图像的当前宽度（以像素为单位）。应用程序将此属性设置为标记要获取的选择区域的宽度。此属性必须与 WIA_IPA_PIXELS_PER_LINE 属性一致。微型驱动程序创建和维护此属性。

对于所有启用购置的项是必需的;即类别中的项：WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK和WIA_CATEGORY_FILM。

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

WIA_IPS_XPOS
ScannerPictureXpos

包含所选图像左上角的 x 坐标（以像素为单位）。应用程序将此属性设置为标记选择区域的左上角。微型驱动程序创建和维护此属性。

对于所有启用购置的项是必需的;即类别中的项：WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK、WIA_CATEGORY_FINISHED_FILE和WIA_CATEGORY_FILM。不支持WIA_CATEGORY_FOLDER项。

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

WIA_IPS_XRES
ScannerPictureXres

包含设备的当前水平分辨率（以每英寸像素为单位）。应用程序设置此属性以设置水平分辨率。微型驱动程序创建和维护此属性。

如果设备只能设置为单个值，请创建一个WIA_PROP_LIST 类型，并在其中放置有效值。这也是一个分辨率设置依赖于另一个分辨率的情况。 (垂直分辨率取决于水平分辨率。)

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

WIA_IPS_XSCALING
ScannerPictureXscaling

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

将水平缩放设置为可应用于扫描程序设备或其驱动程序中扫描的图像的百分比。

对于所有启用购置的项，此属性是可选的;即WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK和WIA_CATEGORY_FILM类型的项。

类型： VT_I4，访问：读/写或只读，有效值： WIA_PROP_LIST 或WIA_PROP_RANGE。

值可以是 1 到最大VT_I4 (0xFFFF) 。例如，100 表示不缩放，050 表示缩减到原始大小的 50%，200 表示纵向扩展到原始大小的 200%。

WIA_IPS_YEXTENT
ScannerPictureYextent

包含要获取的选定图像的当前高度（以像素为单位）。应用程序将此属性设置为标记选择区域的高度。此属性必须与 WIA_IPA_PIXELS_PER_LINE 属性的值一致。微型驱动程序创建和维护此属性。

对于所有启用购置的项是必需的;即类别中的项：WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK和WIA_CATEGORY_FILM。

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

WIA_IPS_YPOS
ScannerPictureYpos

所选图像左上角的当前 y 坐标（以像素为单位）。应用程序将此属性设置为标记选择区域的左上角。微型驱动程序创建和维护此属性。

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

WIA_IPS_YRES
ScannerPictureYres

包含设备的当前垂直分辨率（以每英寸像素为单位）。应用程序将此属性设置为设置垂直分辨率。微型驱动程序创建和维护此属性。

如果设备只能设置为单个值，请创建一个WIA_PROP_LIST 类型，并在其中放置有效值。这也是一个分辨率设置依赖于另一个分辨率的情况。 (水平分辨率取决于垂直分辨率。)

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

WIA_IPS_YSCALING
ScannerPictureYscaling

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

将垂直缩放设置为百分比，该缩放可能应用于扫描程序设备或其驱动程序中的扫描图像。

对于所有启用购置的项，此属性是可选的;即WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK和WIA_CATEGORY_FILM类型的项。

类型： VT_I4，访问：读/写或只读，有效值： WIA_PROP_LIST 或WIA_PROP_RANGE。

值可以是 1 到最大VT_I4 (0xFFFF) 。例如，100 表示不缩放，050 表示缩减到原始大小的 50%，200 表示纵向扩展到原始大小的 200%。

要求

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

扫描程序 WIA 项属性常量

要求

反馈

反馈

其他资源