共用方式為

數位相機裝置屬性常數

  • 發行項

Windows 映像擷取 (WIA) 硬體裝置具有儲存在 Windows 登錄中的屬性值。 如需詳細資訊，請參閱 Common Device Property Constants。

下列裝置屬性常數及其相關聯的字串是數位相機特有的。 前置詞 「WIA_DPC_」 表示相機的裝置屬性，而且是 C/C++ 中使用的命名慣例。 為了編寫腳本目的，這些常數會使用前置詞 「CameraDevice」，而且是 WiaItemPropertyId 列舉類型的一部分。 來自該腳本列舉的對應成員名稱會出現在下列清單中的 C/C++ 常數名稱旁的括弧中。

注意

WIA 不支援 Windows Vista 或更新版本中的相機。 針對這些版本的 Windows，請使用 Windows 驅動程式開發工具組 (DDK) 中所述的 Windows 可攜式裝置 (WPD) API，以從相機取得影像。

 

常數/值 描述
WIA_DPC_PICTURES_TAKEN
CameraDevicePicturesTaken
 相機所拍攝的圖片數目。 minidriver 會建立和維護這個屬性。
類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE
WIA_DPC_PICTURES_REMAINING
CameraDevicePicturesRemaining
 在目前的屬性設定下，可以拍攝的圖片數目。 如果這些設定變更，且變更會影響相機裝置產生的影像大小，WIA 迷你驅動程式應該更新剩餘的圖片數目。 minidriver 會建立和維護這個屬性。
類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE
WIA_DPC_EXPOSURE_MODE
CameraDeviceExposureMode
 指出相機目前的曝光模式。 應用程式會變更此屬性，以控制相機裝置的曝光模式。
類型： VT_I4、Access：讀取/寫入、有效值： 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 的設定會對應至兩個停止更多曝光時間， (感應器) 的四倍更多能源，產生更亮的影像。 -1000 的設定會對應到感應器上) 產生較深影像 (一半能源的一個停止曝光量。 設定值位於相片曝光的加法系統 (APEX) 單位中。 這個屬性可以表示為清單或值範圍。 只有當裝置的 WIA_DPC_EXPOSURE_MODE 屬性設定為 EXPOSUREMODE_MANUAL 時，才會使用這個屬性。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_RANGE 或WIA_PROP_LIST
WIA_DPC_EXPOSURE_TIME
CameraDeviceExposureTime

對應至快門速度，以秒為單位縮放 10，000。 一般而言，只有當WIA_DPC_EXPOSURE_MODE屬性設定為 EXPOSUREMODE_MANUAL 或 EXPOSUREMODE_SHUTTER_PRIORITY 時，裝置才會使用此屬性。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_RANGE 或WIA_PROP_LIST
WIA_DPC_FNUMBER
CameraDeviceFNumber

對應至鏡頭的光圈，以 100 縮放的 f 停止數單位為單位。 只有當WIA_DPC_EXPOSURE_MODE屬性設定為 EXPOSUREMODE_MANUAL 或EXPOSUREMODE_APERTURE_PRIORITY時，此屬性的設定通常才有效。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST
WIA_DPC_FLASH_MODE
CameraDeviceFlashMode

定義相機裝置目前的快閃模式設定。 設備磁碟機會列舉這個屬性支援的值。 應用程式會寫入此屬性，以設定相機裝置的快閃模式。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST

下表有六個與此屬性有效的常數。

快閃模式 定義
FLASHMODE_AUTO 相機裝置會決定適當的快閃設定。
FLASHMODE_FILL 無論目前的光源狀況為何，相機裝置都會設定為閃爍。
FLASHMODE_OFF 相機裝置 設定為不會 針對任何相片閃爍。
FLASHMODE_REDEYE_AUTO 無論目前的光源狀況為何，相機裝置都會使用紅眼縮小來決定適當的閃爍設定。
FLASHMODE_REDEYE_FILL 無論目前的光源狀況為何，相機裝置都會設定為使用紅眼縮小和閃爍。
FLASHMODE_EXTERNALSYNC 相機裝置已設定為與外部快閃單位同步處理。

 
WIA_DPC_FOCUS_MODE
CameraDeviceFocusMode

定義相機裝置目前的焦點模式設定。 設備磁碟機會列舉這個屬性支援的值。 應用程式會寫入這個屬性來設定相機裝置的焦點模式。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST

下表具有這個屬性有效的三個常數。

焦點模式 描述
FOCUSMODE_MANUAL 相機裝置已設定為允許使用者手動專注。
FOCUSMODE_AUTO 相機裝置已設定為自動聚焦。
FOCUSMODE_MACROAUTO 相機裝置會設定為使用短範圍宏設定自動聚焦。

 
WIA_DPC_FOCUS_MANUAL_DIST

保留，請勿使用。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE
WIA_DPC_ZOOM_POSITION

保留，請勿使用。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE
WIA_DPC_PAN_POSITION
CameraDevicePanPosition

保留，請勿使用。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE
WIA_DPC_TILT_POSITION
CameraDeviceTiltPosition

保留，請勿使用。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE
WIA_DPC_TIMER_MODE
CameraDeviceTimerMode

保留，請勿使用。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE
WIA_DPC_TIMER_VALUE
CameraDeviceTimerValue

保留，請勿使用。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE
WIA_DPC_POWER_MODE
CameraDevicePowerMode

定義相機裝置目前的電源。 應用程式會讀取此屬性，以判斷相機所使用的電源來源。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE

下表有兩個與此屬性有效的常數。

電源模式 描述
POWERMODE_LINE 相機裝置正在電源介面卡上運作。
POWERMODE_BATTERY 相機裝置正在電池電力上運作。

 
WIA_DPC_BATTERY_STATUS
CameraDeviceBatteryStatus

剩餘的電池計量百分比，以操作相機裝置。 這個值應該是從 0 到 100 的整數。 應用程式會讀取此屬性，以判斷相機裝置的剩餘電池使用時間。

類型： VT_I4、Access：唯讀、有效值： 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、Access：讀取/寫入、有效值： WIA_PROP_LIST 或WIA_PROP_RANGE
WIA_DPC_PICT_HEIGHT
CameraDevicePictHeight

要用於新擷取影像的圖元高度。 此屬性的有效值清單與 WIA_DPC_PICT_WIDTH 屬性的有效值清單有一對一對應。 如果個別的寬度和高度是線性設定的，且彼此正交，它們可能會以範圍表示。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST 或WIA_PROP_RANGE
WIA_DPC_DIMENSION

保留，請勿使用。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE
WIA_DPC_COMPRESSION_SETTING
CameraDeviceCompressionSetting

在廣泛的場景內容上，其用途大致是線性的影像品質，而且它包含範圍或整數清單。 較小的整數用來代表品質較低的 (，也就是壓縮) 上限，而較大的整數則用來表示品質較高的 (，也就是最小壓縮) 。 裝置上的任何可用設定只會與該裝置相對，因此是裝置特定的設定。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST 或WIA_PROP_RANGE
WIA_DPC_FOCUS_METERING

保留，請勿使用。

類型： VT_I4、Access：唯讀、有效值： 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、Access：讀取/寫入、有效值： WIA_PROP_LIST

下表有三個常數，這些常數對此屬性有效。

效果模式 描述
EFFECTMODE_STANDARD 以相機的標準模式擷取影像。
EFFECTMODE_BW 擷取灰階影像。
EFFECTMODE_SEPIA 擷取分離影像。

 
WIA_DPC_DIGITAL_ZOOM
CameraDeviceDigitalZoom

數位相機取得影像的有效縮放比例，縮放比例為 10。 值為 10 會對應到沒有數位縮放 (1X) ，這是相機所擷取的標準場景大小。 值為 20 會對應至 2X 縮放，其中相機會擷取標準場景大小的一分之一。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST 或WIA_PROP_RANGE
WIA_DPC_SHARPNESS
CameraDeviceSharpness

擷取影像的感知尖度。 此屬性可以使用值清單或值範圍。 最小值代表最少的尖度，而最大值則代表最大尖度。 範圍中間的值通常代表一般或預設的尖角。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST 或WIA_PROP_RANGE
WIA_DPC_CONTRAST
CameraDeviceContrast

所擷取影像的認知對比。 這個屬性可以包含值清單或值範圍。 最小支援值代表最小對比量，而最大值則代表最對比。 一般而言，範圍中間的值代表一般或預設的對比。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST 或WIA_PROP_RANGE
WIA_DPC_CAPTURE_MODE
CameraDeviceCaptureMode

設定影像擷取模式。

類型： VT_I4、Access：讀取/寫入、有效值： 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、Access：讀取/寫入、有效值： WIA_PROP_LIST 或WIA_PROP_RANGE
WIA_DPC_EXPOSURE_INDEX
CameraDeviceExposureIndex

允許模擬數位相機上的電影速度設定。 這些設定會對應至 ASA/DIN) (ISO 指定。 一般而言，裝置支援離散列舉值，但可以持續控制某個範圍的值。 0xFFFF的值會對應至 [自動 ISO] 設定。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST 或WIA_PROP_RANGE
WIA_DPC_EXPOSURE_METERING_MODE
CameraDeviceExposureMeteringMode

指定相機用來自動調整曝光設定的模式。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST

曝光計量模式 描述
EXPOSUREMETERING_AVERAGE 根據整個場景的平均值設定曝光。
EXPOSUREMETERING_CENTERWEIGHT 根據中心加權平均值設定曝光。
EXPOSUREMETERING_MULTISPOT 根據多點模式設定曝光。
EXPOSUREMETERING_CENTERSPOT 根據中心點設定曝光。

 
WIA_DPC_FOCUS_METERING_MODE
CameraDeviceFocusMeteringMode

指定相機用來自動調整焦點的模式。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST

下表有兩個與這個屬性有效的常數。

焦點計量模式 描述
FOCUSMETERING_CENTERSPOT 根據中心點調整焦點。
FOCUSMETERING_MULTISPOT 根據多點模式調整焦點。

 
WIA_DPC_FOCUS_DISTANCE
CameraDeviceFocusDistance

數位相機影像擷取平面與焦點點之間的距離，以公釐為單位。 0xFFFF的值對應至大於 655 公尺的設定。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST 或WIA_PROP_RANGE
WIA_DPC_FOCAL_LENGTH
CameraDeviceFocalLength

35mm 對等的焦點長度。 此屬性的值會對應至公釐乘以 100 的焦點長度。 焦點長度決定光學縮放。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_NONE
WIA_DPC_RGB_GAIN
CameraDeviceRGBGain

Null 終止的 Unicode 字串，分別代表套用至影像資料的紅色、綠色和藍色增益。 例如，「4：25：50」 代表紅色增益 4、綠色增益為 25，而藍色增益為 50。

類型： VT_BSTR、Access：讀取/寫入、有效值： WIA_PROP_NONE
WIA_DPC_WHITE_BALANCE
CameraDeviceWhiteBalance

指定數位相機如何加權色彩通道。

類型： VT_I4、Access：讀取/寫入、有效值： 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 是在從裝置取得影像或物件之後，可以上傳至 ，根據下列其中一個案例。

  • WIA 應用程式會讀取此屬性，並允許使用者自動將影像上傳至 URL。
  • 應用程式會設定 URL 和其他裝置 (kiosk，依此類推) 使用此屬性。

Microsoft Windows 本身不會上傳影像。

類型： VT_BSTR、Access：讀取/寫入、有效值： WIA_PROP_NONE
WIA_DPC_ARTIST
CameraDeviceArtist

擁有者 (的名稱，這是裝置的目前使用者) 。 裝置會使用這個屬性，在擷取的每個 EXIF 影像中填入[藝術師] 欄位。

類型： VT_BSTR、Access：讀取/寫入、有效值： WIA_PROP_NONE
WIA_DPC_COPYRIGHT_INFO
CameraDeviceCopyrightInfo

著作權通知。 裝置會使用這個屬性，在擷取的每個 EXIF 影像中填入 [著作權] 欄位。

類型： VT_BSTR、Access：讀取/寫入、有效值： WIA_PROP_NONE

規格需求

需求 值
最低支援的用戶端
 Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2003 [僅限傳統型應用程式]
標頭
Wiadef.h