WIA_IPA_DATATYPE

WIA_IPA_DATATYPE 属性包含设备的当前数据类型设置。 WIA 微型驱动程序创建和维护此属性。

属性类型:VT_I4

有效值:WIA_PROP_LIST

访问权限:读/写

注解

应用程序读取 WIA_IPA_DATATYPE 属性以确定图像的数据类型。 应用程序写入此属性以设置要传输的图像的当前数据类型。

下表描述了当 WIA_IPA_FORMAT 属性未设置为 WiaImgFmt_RAW 时 ,WIA_IPA_DATATYPE 有效的常量。

数据类型 说明
WIA_DATA_AUTO 此值适用于所有可编程图像数据源项,包括 Flatbed 和 Feeder。 当 WIA 微型驱动程序支持此值时,WIA 应用程序客户端可以设置: WIA_IPA_DATATYPE ,以便在设备上启用自动颜色检测。

设置WIA_DATA_AUTO后,WIA 微型驱动程序必须将同一项上的 WIA_IPA_DEPTH 更新为WIA_DEPTH_AUTO (如果设备支持自动颜色) ,则该值必须是受支持的值。

当支持 WIA_DEPTH_AUTO WIA_IPA_DEPTH值时, WIA_IPA_DATATYPE 值WIA_DATA_AUTO不再可选,并成为必需值。
WIA_DATA_COLOR 扫描数据为红-绿-蓝 (RGB) 。 使用以下 WIA 属性描述全彩色格式:

WIA_IPA_CHANNELS_PER_PIXEL

WIA_IPA_BITS_PER_CHANNEL

WIA_IPA_PLANAR

WIA_IPA_PIXELS_PER_LINE

WIA_IPA_BYTES_PER_LINE

WIA_IPA_NUMBER_OF_LINES
WIA_DATA_COLOR_DITHER 与 WIA_DATA_COLOR 相同,只是使用当前所选的 dither 模式对数据进行抖变。
WIA_DATA_COLOR_THRESHOLD 颜色阈值数据。
WIA_DATA_DITHER 扫描数据通过使用当前所选的抖变模式进行抖变。
WIA_DATA_GRAYSCALE 扫描数据表示强度。 调色板是固定的、间距相等的灰度,具有 WIA_IPA_DEPTH 属性指定的深度。
WIA_DATA_THRESHOLD 阈值是黑白数据的每个像素 1 位。 WIA_IPS_THRESHOLD当前值的数据将转换为白色;此值下的数据将转换为黑色。

WIA_IPA_DATATYPE 属性还用于描述应用程序将 WIA_IPA_FORMAT 属性设置为值WiaImgFmt_RAW时要使用的 RAW 数据传输类型。 驱动程序应将 WIA_IPA_DATATYPE 属性设置为应用程序可以从中选取的允许值列表。

下表列出了当 WIA_IPA_FORMAT 设置为 WiaImgFmt_RAW 时对 WIA_IPA_DATATYPE 有效的常量。

数据类型 说明
WIA_DATA_GRAYSCALE 扫描数据表示强度。 调色板是固定的、间距相等的灰度,具有 WIA_IPA_DEPTH 属性指定的深度。

WIA_IPA_RAW_BITS_PER_CHANNEL 属性必须设置为 1。
WIA_DATA_RAW_BGR 扫描数据位于 BGR (蓝-绿-红) 颜色空间中。 使用以下 WIA 属性描述全彩色格式:

WIA_IPA_CHANNELS_PER_PIXEL

WIA_IPA_BITS_PER_CHANNEL

WIA_IPA_PIXELS_PER_LINE

WIA_IPA_BYTES_PER_LINE

WIA_IPA_NUMBER_OF_LINES

WIA_IPA_RAW_BITS_PER_CHANNEL必须设置为 3。
WIA_DATA_RAW_CMY 扫描数据位于青红色-黄色 (CMY) 颜色空间中。 使用为WIA_DATA_RAW_BGR列出的相同 WIA 属性来描述全彩色格式。

WIA_IPA_RAW_BITS_PER_CHANNEL必须设置为 3。
WIA_DATA_RAW_CMYK 扫描数据位于青色-洋红色-黄色-黑色 (CMYK) 颜色空间中。 使用为WIA_DATA_RAW_BGR列出的相同 WIA 属性来描述全彩色格式。

WIA_IPA_RAW_BITS_PER_CHANNEL必须设置为 4。
WIA_DATA_RAW_RGB 扫描数据位于红-绿-蓝 (RGB) 颜色空间中。 使用与 WIA_DATA_RAW_BGR 中相同的 WIA 属性描述全彩色格式。

WIA_IPA_RAW_BITS_PER_CHANNEL必须设置为 3。
WIA_DATA_RAW_YUV 扫描数据 (YUV) 颜色空间的亮度-蓝色差异-红色差异。 使用为WIA_DATA_RAW_BGR列出的相同 WIA 属性来描述全彩色格式。

WIA_IPA_RAW_BITS_PER_CHANNEL必须设置为 3。
WIA_DATA_RAW_YUVK 扫描数据位于 luminance-blue difference-red difference-black (YUVK) colorspace 中。 使用为WIA_DATA_RAW_BGR列出的相同 WIA 属性来描述全彩色格式。

WIA_IPA_RAW_BITS_PER_CHANNEL必须设置为 4。

如果可以将设备设置为仅单个值,请创建一个WIA_PROP_LIST类型,并将有效值放入其中。

检查 WIA_IPA_DEPTH 属性以确定位深度。

WIA_IPA_DATATYPE 属性通常包含相机的单个值。

要求

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

另请参阅

WIA_IPA_BITS_PER_CHANNEL

WIA_IPA_BYTES_PER_LINE

WIA_IPA_CHANNELS_PER_PIXEL

WIA_IPA_DEPTH

WIA_IPA_FORMAT

WIA_IPA_NUMBER_OF_LINES

WIA_IPA_PIXELS_PER_LINE

WIA_IPA_PLANAR

WIA_IPA_RAW_BITS_PER_CHANNEL

WIA_IPS_THRESHOLD