相机设备属性常量

  • 项目

Windows 映像获取 (WIA) 硬件设备具有存储在 Windows 注册表中的属性值。 有关详细信息，请参阅 通用设备属性常量。

以下设备属性常量及其关联的字符串特定于数码相机。 前缀“WIA_DPC_”表示相机的设备属性，是 C/C++ 中使用的命名约定。 出于脚本编写目的，这些常量使用前缀“CameraDevice”，是 WiaItemPropertyId 枚举类型的一部分。 该脚本枚举中的相应成员名称显示在以下列表中的 C/C++ 常量名称旁边的括号中。

注意

WIA 不支持 Windows Vista 或更高版本中的相机。 对于这些版本的 Windows，请使用 Windows 驱动程序开发工具包 (DDK) 中所述的 Windows 便携式设备 (WPD) API 从相机获取图像。

 

常量/值 说明
WIA_DPC_PICTURES_TAKEN
CameraDevicePicturesTaken
 相机拍摄的照片数。 微型驱动程序创建和维护此属性。
类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE
WIA_DPC_PICTURES_REMAINING
CameraDevicePicturesRemaining
 给定当前属性设置，可以拍摄的图片数。 如果这些设置发生更改，并且更改会影响相机设备生成的图像大小，WIA 微型驱动程序应更新剩余图片的数量。 微型驱动程序创建和维护此属性。
类型： VT_I4，访问：只读，有效值： WIA_PROP_NONE
WIA_DPC_EXPOSURE_MODE
CameraDeviceExposureMode
 指示相机的当前曝光模式。 应用程序更改此属性以控制相机设备的曝光模式。
类型： VT_I4，访问：读/写，有效值： WIA_PROP_LIST
下表包含对此属性有效的七个常量。
曝光模式 说明
EXPOSUREMODE_MANUAL 快门速度和光圈由用户设置。
EXPOSUREMODE_AUTO 快门速度和光圈由相机自动设置。
EXPOSUREMODE_APERTURE_PRIORITY 光圈由用户设置，相机会自动设置快门速度。
EXPOSUREMODE_SHUTTER_PRIORITY 快门速度由用户设置，相机会自动设置光圈。
EXPOSUREMODE_PROGRAM_CREATIVE 快门速度和光圈由相机自动设置，针对静态主题进行优化。
EXPOSUREMODE_PROGRAM_ACTION 快门速度和光圈由相机自动设置，针对包含快速运动的场景进行优化。
EXPOSUREMODE_PORTRAIT 快门速度和光圈由相机自动设置，针对肖像摄影进行优化。

 
WIA_DPC_EXPOSURE_COMP
CameraDeviceExposureComp

允许调整数码相机的自动曝光控件的设置点。 例如，设置为零不会更改工厂设置的自动曝光级别。 单位以“停止”为单位，按 1000 倍缩放，以允许小数停止值。 设置为 2000 表示两个停止曝光， (传感器) 能量增加 4 倍，从而生成更亮的图像。 设置为 -1000 表示曝光少一点， (传感器上能量的一半) 产生较暗的图像。 设置值在摄影曝光的附加系统 (APEX) 单位中。 此属性可以表示为列表或值范围。 仅当设备的 WIA_DPC_EXPOSURE_MODE 属性设置为 EXPOSUREMODE_MANUAL 时，才使用此属性。

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

对应于快门速度，以秒为单位，缩放比例为 10，000。 通常，仅当 WIA_DPC_EXPOSURE_MODE 属性设置为 EXPOSUREMODE_MANUAL 或 EXPOSUREMODE_SHUTTER_PRIORITY 时，设备才使用此属性。

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

对应于镜头的光圈，以 f-stop 数的单位（按 100 缩放）。 仅当 WIA_DPC_EXPOSURE_MODE 属性设置为 EXPOSUREMODE_MANUAL 或 EXPOSUREMODE_APERTURE_PRIORITY 时，此属性的设置通常才有效。

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

定义相机设备的当前闪光灯模式设置。 设备驱动程序枚举此属性支持的值。 应用程序写入此属性以设置相机设备的闪光灯模式。

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

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

闪存模式 定义
FLASHMODE_AUTO 相机设备确定正确的闪光灯设置。
FLASHMODE_FILL 无论当前照明条件如何，相机设备都配置为闪烁。
FLASHMODE_OFF 相机设备配置为 不 闪烁拍摄的任何照片。
FLASHMODE_REDEYE_AUTO 无论当前照明条件如何，相机设备都会使用红眼减少来确定正确的闪光灯设置。
FLASHMODE_REDEYE_FILL 无论当前照明条件如何，相机设备都配置为使用红眼减少和闪光灯。
FLASHMODE_EXTERNALSYNC 相机设备配置为与外部闪光灯单元同步。

 
WIA_DPC_FOCUS_MODE
CameraDeviceFocusMode

定义相机设备的当前焦点模式设置。 设备驱动程序枚举此属性支持的值。 应用程序写入此属性以设置相机设备的焦点模式。

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

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

焦点模式 说明
FOCUSMODE_MANUAL 相机设备配置为允许用户手动对焦。
FOCUSMODE_AUTO 相机设备配置为自动对焦。
FOCUSMODE_MACROAUTO 相机设备配置为使用短距离宏设置自动对焦。

 
WIA_DPC_FOCUS_MANUAL_DIST

保留，请勿使用。

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

保留，请勿使用。

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

保留，请勿使用。

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

保留，请勿使用。

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

保留，请勿使用。

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

保留，请勿使用。

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

定义相机设备的当前电源。 应用程序读取此属性以确定相机使用的电源。

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

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

电源模式 说明
POWERMODE_LINE 相机设备在电源适配器上运行。
POWERMODE_BATTERY 相机设备使用电池供电。

 
WIA_DPC_BATTERY_STATUS
CameraDeviceBatteryStatus

剩余用于操作相机设备的电池电量的百分比。 此值应为 0 到 100 的整数。 应用程序读取此属性以确定相机设备的剩余电池使用时间。

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

要用于新捕获图像的缩略图图像的宽度（以像素为单位）。 应用程序读取此值以获取在其用户界面中显示缩略图的估计大小。

类型： VT_I4，Access：读/写 (WIA_PROP_LIST) 或只读 (WIA_PROP_NONE) ，有效值：WIA_PROP_LIST或WIA_PROP_NONE
WIA_DPC_THUMB_HEIGHT
CameraDeviceThumbHeight

要用于新捕获图像的缩略图图像的宽度（以像素为单位）。 应用程序读取此值以获取在其用户界面中显示缩略图的估计大小。

类型： VT_I4，Access：读/写 (WIA_PROP_LIST) 或只读 (WIA_PROP_NONE) ，有效值：WIA_PROP_LIST或WIA_PROP_NONE
WIA_DPC_PICT_WIDTH
CameraDevicePictWidth

要用于新捕获图像的宽度（以像素为单位）。 此属性的有效值列表与 WIA_DPC_PICT_HEIGHT 属性的有效值列表具有一对一的对应关系。 如果单个宽度和高度可线性设置且彼此正交，则它们可以表示为一个范围。

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

要用于新捕获图像的高度（以像素为单位）。 此属性的有效值列表与 WIA_DPC_PICT_WIDTH 属性的有效值列表具有一对一的对应关系。 如果单个宽度和高度可线性设置且彼此正交，则它们可以表示为一个范围。

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

保留，请勿使用。

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

旨在与各种场景内容上感知到的图像质量大致呈线性关系，并且它包含一个范围或一个整数列表。 较小的整数用于表示低质量 (即最大压缩) ，而较大的整数用于表示更高质量的 (即最小压缩) 。 设备上的任何可用设置仅相对于该设备，因此特定于设备。

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

保留，请勿使用。

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

在延时捕获操作中，图像捕获之间的时间（以毫秒为单位）。

类型： VT_I4、Access：读/写、有效值： WIA_PROP_NONE、WIA_PROP_LIST或WIA_PROP_RANGE
WIA_DPC_TIMELAPSE_NUMBER
CameraDeviceTimelapseNumber

设备在延时捕获期间尝试捕获的图像数。

类型： VT_I4、Access：读/写、有效值： WIA_PROP_NONE、WIA_PROP_LIST或WIA_PROP_RANGE
WIA_DPC_BURST_INTERVAL
CameraDeviceBurstInterval

突发操作期间图像捕获之间的时间（以毫秒为单位）。

类型： VT_I4、Access：读/写、有效值： WIA_PROP_NONE、WIA_PROP_LIST或WIA_PROP_RANGE
WIA_DPC_BURST_NUMBER
CameraDeviceBurstNumber

设备在突发操作期间尝试捕获的图像数。

类型： VT_I4、Access：读/写、有效值： WIA_PROP_NONE、WIA_PROP_LIST或WIA_PROP_RANGE
WIA_DPC_EFFECT_MODE
CameraDeviceEffectMode

指定相机的特殊图像获取模式。

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

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

效果模式 说明
EFFECTMODE_STANDARD 在相机的标准模式下捕获图像。
EFFECTMODE_BW 捕获灰度图像。
EFFECTMODE_SEPIA 捕获棕褐色图像。

 
WIA_DPC_DIGITAL_ZOOM
CameraDeviceDigitalZoom

数码相机获取的图像的有效缩放比例为 10 倍。 值 10 对应于没有数字缩放 (1X) ，这是相机捕获的标准场景大小。 值 20 对应于 2X 缩放，其中四分之一的标准场景大小由相机捕获。

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

所捕获图像的感知锐度。 此属性可以使用值列表或值范围。 最小值表示最小锐度，而最大值表示最大锐度。 通常，范围中间的一个值表示正常或默认的锐度。

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

捕获图像的感知对比度。 此属性可以包含值列表或值范围。 支持的最小值表示最小对比度，而最大值表示对比度最大。 通常，该区域中间的一个值表示正常或默认的对比度。

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

设置图像捕获模式。

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

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

捕获模式 说明
CAPTUREMODE_NORMAL 相机的正常模式。
CAPTUREMODE_BURST 根据 WIA_DPC_BURST_NUMBER 和 WIA_DPC_BURST_INTERVAL 属性的值定义，快速连续捕获多个图像。
CAPTUREMODE_TIMELAPSE 按照 WIA_DPC_TIMELAPSE_NUMBER 和 WIA_DPC_TIMELAPSE_INTERVAL 属性定义，连续捕获多个图像。

 
WIA_DPC_CAPTURE_DELAY
CameraDeviceCaptureDelay

该值表示应在捕获触发器和数据捕获的实际启动之间插入的时间延迟量（以毫秒为单位）。 此属性不用于描述单启动、多个捕获（如突发或时差）的帧之间的时间，这些帧具有单独的间隔属性 WIA_DPC_BURST_INTERVAL 和 WIA_DPC_TIMELAPSE_INTERVAL。 在这些情况下，在捕获系列中的第一个图像之前，它仍充当初始延迟，与帧之间的时间无关。 对于无预捕获延迟，此属性应设置为零。

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

允许在数码相机上模拟胶片速度设置。 这些设置对应于 ASA/DIN) (ISO 标识。 通常，设备支持离散枚举值，但可以连续控制一定范围的值。 值0xFFFF对应于自动 ISO 设置。

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

指定相机用于自动调整曝光设置的模式。

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

曝光计数模式 说明
EXPOSUREMETERING_AVERAGE 根据整个场景的平均值设置曝光。
EXPOSUREMETERING_CENTERWEIGHT 根据中心加权平均值设置曝光。
EXPOSUREMETERING_MULTISPOT 根据多点模式设置曝光。
EXPOSUREMETERING_CENTERSPOT 根据中心点设置曝光。

 
WIA_DPC_FOCUS_METERING_MODE
CameraDeviceFocusMeteringMode

指定相机用于自动调整焦点的模式。

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

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

焦点计量模式 说明
FOCUSMETERING_CENTERSPOT 根据中心点调整焦点。
FOCUSMETERING_MULTISPOT 根据多点模式调整焦点。

 
WIA_DPC_FOCUS_DISTANCE
CameraDeviceFocusDistance

数码相机的图像捕获平面与焦点之间的距离（以毫米为单位）。 值0xFFFF对应于大于 655 米的设置。

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

35 毫米等效焦距。 此属性的值对应于焦距（以毫米为单位）乘以 100。 焦距决定光学缩放。

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

以 null 结尾的 Unicode 字符串，分别表示应用于图像数据的红色、绿色和蓝色增益。 例如，“4：25：50”表示红色增益 4，绿色增益为 25，蓝色增益为 50。

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

指定数码相机如何加权颜色通道。

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

下面是此属性的可能值的列表。

白平衡 说明
WHITEBALANCE_MANUAL 白平衡是直接使用 WIA_DPC_RGB_GAIN 属性设置 的 。
WHITEBALANCE_AUTO 相机使用自动机制设置白平衡。
WHITEBALANCE_ONEPUSH_AUTO 当用户将相机指向白色表面时按下捕获按钮时，相机将确定白平衡设置。
WHITEBALANCE_DAYLIGHT 相机将白平衡设置为适合在白天使用的值。
WHITEBALANCE_FLORESCENT 相机将白平衡设置为适合用于荧光光源的值。
WHITEBALANCE_TUNGSTEN 相机将白平衡设置为适合与碳化光源配合使用的值。
WHITEBALANCE_FLASH 相机将白平衡设置为适合用于电子闪光灯的值。

 
WIA_DPC_UPLOAD_URL
CameraDeviceUploadURL

描述 URL。 根据以下方案之一，此 proroperty 描述的 URL 是从设备获取图像或对象后可以上传到的 URL。

  • WIA 应用程序读取此属性并允许用户自动将图像上传到 URL。
  • 应用程序设置 URL，其他设备 (展台等) 使用此属性。

Microsoft Windows 本身不会上传图像。

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

所有者的名称 (设备的当前用户) 。 设备使用此属性来填充它捕获的每个 EXIF 图像中的“艺术家”字段。

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

版权通知。 设备使用此属性来填充它捕获的每个 EXIF 图像中的“版权”字段。

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

要求

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