常见的 WIA 项属性常量
除非在说明中另有说明，否则所有 IWiaItem、 IWiaItem2 和 IWiaDrvItem 接口 接口必须支持以下设备属性常量。
前缀“WIA_IPA_”指示所有设备的项属性，是 C/C++ 中使用的命名约定。 出于脚本编写目的，这些常量使用前缀“Picture”，并且是 WiaItemPropertyId 枚举类型的一部分。 该脚本枚举中的相应成员名称显示在以下列表中的 C/C++ 常量名称旁边的括号中。
| 常量/值 | 说明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
此标志控制对项的访问以及是否删除该项。 对于所有 WIA 2.0 项是必需的。 类型： VT_I4;读取/写入或只读，具体取决于项目更改其访问权限的能力;有效值：WIA_PROP_FLAG 下表包含对此属性有效的五个标志。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
此属性由 保留供将来使用，目前未实现。 类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含图像的每个通道的位数。 微型驱动程序创建和维护此属性。 对于所有启用 WIA 2.0 获取或存储的映像项是必需的。 类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含数据传输期间使用的缓冲区的大小（以字节为单位）。 微型驱动程序创建和维护此属性。 应用程序可以读取此属性，以确定驱动程序指定的数据传输缓冲区大小。 WIA 服务还会读取此属性，以便在数据传输期间为微型驱动程序分配内存 对于所有已启用传输的 WIA 2.0 项，可选。 类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE
注意： |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含图像的一个扫描行中的字节数。 微型驱动程序创建和维护此属性。 对于所有 WIA 2.0 项都是可选的。 类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含图像的每个像素的通道数。 微型驱动程序创建和维护此属性。 对于所有启用 WIA 2.0 获取或存储的映像项是必需的。 类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
此属性由 保留供将来使用，目前未实现。 类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含使用的当前压缩类型。 微型驱动程序创建和维护此属性。 应用程序读取此属性以确定图像压缩类型，或设置此属性以配置压缩设置。 类型： VT_I4，访问：读/写，有效值： WIA_PROP_LIST 下表包含对此属性有效的常量。 V 符号指示该常量仅在 Windows Vista 及更高版本中受支持。 (它只能通过 IWiaItem2 interface.)
[！注意] 当此属性WIA_COMPRESSION_NONE且WIA_IPA_FORMAT为WiaImgFmt_PDFA或WiaImgFmt_XPS时;则WIA_COMPRESSION_NONE意味着压缩模式未定义，扫描程序必须决定某个模式。 WIA_COMPRESSION_AUTO是为 WIA_IPA_COMPRESSION 属性定义的新属性值。 此值对所有可编程图像数据源项有效，包括平板和送纸器。 当 WIA 微型驱动程序支持此值时，WIA 应用程序客户端可以设置WIA_IPA_COMPRESSION，以便在设备上启用自动压缩模式检测。 WIA_COMPRESSION_AUTO可以使用和不使用支持或启用完全自动颜色 (WIA_DATA_AUTO 和WIA_DEPTH_AUTO) 。 WIA_COMPRESSION_AUTO对于支持多种数据类型和位深度（例如WiaImgFmt_RAW）的传输文件格式最有用。 有关传输文件格式的详细信息，请参阅此表中的WIA_IPA_FORMAT。 WIA 微型驱动程序支持WIA_COMPRESSION_AUTO是可操作性的。 如果受支持，WIA 微型驱动程序不得将其设置为WIA_IPA_COMPRESSION的默认值;只有 WIA 应用程序可以设置此值。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含设备的当前数据类型设置。 微型驱动程序创建和维护此属性。 应用程序读取此属性以确定图像的数据类型。 应用程序写入此属性以设置即将传输的图像的当前数据类型。 此属性是所有 WIA 2.0 项所必需的。 对于所有启用 WIA 2.0 获取的项，它必须是读/写，对于 WIA 2.0 存储项，它必须是只读的。 类型： VT_I4;适用于 Windows Vista 之前的操作系统的访问权限：此属性对于相机为只读，对于扫描仪为读/写;Windows Vista 及更高版本的访问权限：此属性对于WIA_CATEGORY_FOLDER和WIA_CATEGORY_FINISHED_FILE项为只读，对于所有其他 WIA 2.0 项类别为读/写;有效值： WIA_PROP_LIST 下表包含六个常量，当 WIA_IPA_FORMAT 未设置为 WiaImgFmt_RAW 时，这些常量与 有效。
WIA_IPA_DATATYPE 属性还用于描述应用程序设置WiaImgFmt_RAW时要使用的 RAW 数据传输的类型。 驱动程序应将 WIA_IPA_DATATYPE 属性设置为允许的值列表，应用程序可以从中选取一个值。 如果设备只能设置为单个值，请创建 WIA_PROP_LIST 类型，并在其中放置有效值。 检查 WIA_IPA_DEPTH 属性以确定位深度。 此属性通常包含相机的单个值。 下表列出了当 WIA_IPA_FORMAT 设置为 WiaImgFmt_RAW 时， WIA_IPA_DATATYPE 有效的常量。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
WIA_IPA_DEPTH 包含图像的位深度设置。 微型驱动程序创建和维护此属性。应用程序读取此属性以确定图像的位深度设置。 应用程序还可以将此值设置为所需的位深度。 如果设备只能设置为单个值，请创建 一个WIA_PROP_LIST 类型，并在其中放置有效值。 此属性是所有 WIA 2.0 项所必需的。 对于所有启用 WIA 2.0 获取的项，它必须是读/写，对于 WIA 2.0 存储项，它必须是只读的。 类型： VT_I4;Windows Vista 之前的操作系统的访问权限：读/写;Windows Vista 及更高版本的访问权限：此属性对于WIA_CATEGORY_FOLDER和WIA_CATEGORY_FINISHED_FILE项为只读，对于所有其他 WIA 2.0 项类别为读/写;有效值： WIA_PROP_LIST WIA_DEPTH_AUTO定义为每像素 0 位，它是为WIA_IPA_DEPTH定义的新属性值。 此值对所有可编程图像数据源项有效，包括平板和送纸器。 WIA 微型驱动程序支持WIA_DEPTH_AUTO时，WIA 应用程序客户端可以将WIA_IPA_DEPTH设置为此值，以便在设备上启用自动颜色检测。 设置WIA_DEPTH_AUTO后，如果设备支持自动颜色) ，WIA 微型驱动程序必须将同一项上的WIA_IPA_DATATYPE更新为WIA_DATA_AUTO (该值必须是受支持的值。 WIA_DEPTH_AUTO 是一个可选值，但当WIA_IPA_DATATYPE支持WIA_DATA_AUTO时，它是必需的。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含特定文件格式的文件扩展名。 微型驱动程序创建和维护此属性。 对于所有已启用传输的 WIA 2.0 项，可选。 类型： VT_BSTR，访问：只读，有效值： WIA_PROP_NONE 驱动程序更新此属性以反映 WIA_IPA_FORMAT 属性的当前值。 例如，如果 WIA_IPA_FORMAT WiaImgFmt_JPEG，则 WIA_IPA_FILENAME_EXTENSION 应为 jpg。 如果 WiaImgFmt_BMP WIA_IPA_FORMAT，则WIA_IPA_FILENAME_EXTENSION应为 BMP。
注意： 对于支持标准格式的驱动程序，建议使用此属性，对于实现自定义定义格式的驱动程序，此属性是必需的。 它会通知应用程序在传输专用格式的文件期间要使用的正确文件扩展名。 例如，如果 A. Datum Corporation 创建了以新格式传输文件的 WIA 驱动程序，则公司可以指定“adc”的扩展名。 这允许应用程序以该格式将数据传输到文件，并创建 myfile.adc 等文件名，这对于了解新扩展名的其他人很有用。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含要传输的图像的当前格式。 应用程序读取此属性以确定它即将接收的图像的格式。 应用程序写入此属性以设置格式。 此属性取决于 WIA_IPA_TYMED 属性。 微型驱动程序创建和维护此属性。 如果设备只能设置为单个值，请创建 WIA_PROP_LIST 类型，并在其中放置有效值。 类型： CLSID、Access：读/写、有效值： WIA_PROP_LIST 下表列出了对此属性有效的常量。 星号 * 表示常量在 Windows Vista 中不受支持。 (它只能通过 IWiaItem 接口使用。) 双星号 ** 表示 Windows Server 2003 或 Windows Vista 不支持常量。 V 符号指示常量仅在 Windows Vista 及更高版本中受支持。 (它只能通过 IWiaItem2 接口使用。)
注意： |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含完整的项名称 (项名称以及路径信息) 。 完整项名称与 wiasCreateDrvItem 服务实用工具函数的 bstrFullItemName 参数相同。 应用程序读取此属性以确定它当前正在使用的项以及该项在项树中的位置。 每个项都应具有唯一的名称。 应用程序通常使用完整的项名称来搜索项树中的项。 WIA 服务创建和维护此属性。 对于所有 WIA 2.0 项是必需的。 类型： VT_BSTR，访问：只读，有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
此属性保留供将来使用，目前未实现。 类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含正确解码映像所需的 ICM 配置文件名称。 应用程序读取此属性以确定处理图像时要使用的 ICM 配置文件。 WIA 服务基于驱动程序安装文件中的 ICMProfiles 条目创建和维护此属性。 类型： VT_BSTR，访问：只读，有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
仅在 Windows Vista 及更高版本中受支持。 WIA 2.0 项分为多个类别，这些类别定义如何处理或使用 IWiaItem2 。 例如，如果项表示一个馈送器，则应用程序应期望它包含所需的文档馈送器属性，并像文档馈送器一样运行。 如果项表示已完成的文件，则 WIA 2.0 应用程序应以这种方式处理它，假设数据是静态的并且位于设备上。 (每个项的规则将在各个规范文档中定义。) 对于所有 WIA 2.0 项是必需的。 类型： VT_CLSID、Access：只读、有效值： 项类别 GUID |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含 WIA 项的描述性标志。 项标志与 wiasCreateDrvItem 服务实用工具函数的 lObjectFlags 参数中的标志相同。 WIA 服务创建和维护此属性。 应用程序读取此属性以确定项的描述性标志值。 类型： VT_I4 访问：只读，有效值： WIA_PROP_NONE 下表包含对此属性有效的标志。 星号 * 表示该标志在 Windows Vista 或更高版本中不受支持。 (它只能通过 IWiaItem 接口使用。) 双星号 ** 表示 Windows Server 2003 或 Windows Vista 或更高版本不支持标志。 V 符号指示标志仅在 Windows Vista 及更高版本中受支持。 (它只能通过 IWiaItem2 接口使用。)
根据项的类别，其中一些标志对于 WIA 2.0 项目是必需的或可选的，如此表所示。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含项名称。 应用程序读取此属性以确定它当前正在使用的项。 每个项都有一个唯一的名称。 WIA 服务创建和维护此属性。 对于所有 WIA 2.0 项是必需的。 类型： VT_BSTR，访问：只读，有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含与项关联的数据的当前大小（以字节为单位）。 微型驱动程序创建和维护此属性。 Contains 是正在传输的数据的总大小。 如果此值为零，则表示微型驱动程序没有有关数据的确切大小的信息。 (这很常见于压缩的数据。) 应用程序读取此值以确定购置发生前的大小。 WIA 服务读取此属性以帮助为数据传输分配内存。 有关详细信息，请参阅将数据 传输到 WIA 应用程序 ，如果 属性设置为零，并且为文件传输配置了 TYMED，WIA 服务不会为 WIA 微型驱动程序分配任何内存。 对于所有启用传输的 WIA 2.0 项是必需的。 类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含最初捕获映像的时间。 微型驱动程序创建和维护此属性。 此属性应以 SYSTEMTIME 结构的形式报告为八个 WORD 值的向量， (平台 SDK 文档) 中所述。 对于所有 WIA 2.0 项都是可选的。 类型： VT_UI2 | VT_VECTOR Access：读/写或只读，有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
仅在 Windows Vista 及更高版本中受支持。 指定WIA_CATEGORY_FOLDER项中存储的项数。 类型： VT_I4，访问：读/写，有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
指定数据传输中使用的最小缓冲区大小。 如果通过回调机制执行数据传输，属性值可以小到 64KB。 但是，如果传输到文件，则属性值是一次传输一页数据所需的字节数。 微型驱动程序创建和维护此 WIA 属性。 对于所有已启用传输的 WIA 2.0 项，可选。 类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含图像中包含的行数 (图像的垂直高度（以像素) 为单位）。 微型驱动程序创建和维护此属性。 对于所有 WIA 2.0 项都是可选的。 类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含图像每行中的像素数 (图像宽度（以像素) 为单位）。 微型驱动程序创建和维护此属性。 对于所有 WIA 2.0 项都是可选的。 类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Windows Vista 及更高版本不支持此属性。 包含图像数据打包选项。 微型驱动程序创建和维护此属性。 应用程序读取此属性以确定映像打包选项或设置当前映像打包选项。 类型： VT_I4;访问：读/写;有效值： WIA_PROP_LIST。 如果设备只能设置为单个值，请创建一个WIA_PROP_LIST类型，并在其中放置有效值。 下表包含对此属性有效的两个常量。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含此微型驱动程序传输的图像的首选格式。 微型驱动程序创建和维护此属性。 对于所有启用传输的 WIA 2.0 项是必需的。 类型： CLSID，访问：只读，有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
指定表示一组设备属性值的 CLSID。 如果设备驱动程序实现此功能，应用程序将使用此属性来确定设备是否支持一组值。 类型： CLSID、Access：只读、有效值： WIA_PROP_LIST 下表包含对此属性有效的 12 个常量。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
仅在 Windows Vista 及更高版本中受支持。 包含每个通道中的位数。 此属性应报告为与通道数量一样多的 BYTE 值的向量，其中第一个 BYTE 对应于第一个通道中的位数，第二个字节对应于第二个通道中的位数，等等。 根据WIA_IPA_CHANNELS_PER_PIXEL，需要有与频道数量一样多的条目。 当应用程序切换到 WiaImgFmt_RAW 时，驱动程序设置该属性。 对于已知子类型，条目数与表中WIA_IPA_RAW_SUBTYPE下列出的条目数一样多。 类型： VT_UI1|VT_VECTOR、Access：只读、有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
此属性由 保留供将来使用，目前未实现。 类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
指定是否禁止显示设备上项的常规属性页。 此属性在 Windows XP 及更高版本上可用。 类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE 下表包含对此属性有效的常量。 星号 * 表示常量在 Windows Vista 及更高版本中无效。 (它只能通过 IWiaItem interface.)
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
此属性包含传输方法设置。 微型驱动程序创建和维护此属性。 应用程序读取此属性以确定微型驱动程序的数据传输方法。 对于所有启用传输的 WIA 2.0 项是必需的。 类型： VT_I4，访问：读/写，有效值： WIA_PROP_LIST 下表包含对此属性有效的常量。 星号 * 表示在 Windows Vista 及更高版本中无效的常量。 (它们只能通过 IWiaItem interface.)
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
仅在 Windows Vista 及更高版本中受支持。 指定要为项上传的字节数。 类型： VT_I4，访问：读/写，有效值： WIA_PROP_NONE |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 |
Windows Server 2008 [仅限桌面应用] |
| Header |
|