次の方法で共有

カメラ デバイスプロパティ定数

  • [アーティクル]

Windows イメージ取得 (WIA) ハードウェア デバイスには、Windows レジストリに格納されているプロパティ値があります。 詳細については、「 Common Device Property Constants」を参照してください。

次のデバイス プロパティ定数と関連付けられた文字列は、デジタル カメラに固有です。 プレフィックス "WIA_DPC_" は、カメラの Device プロパティを示し、C/C++ で使用される名前付け規則です。 スクリプトの目的で、これらの定数はプレフィックス "CameraDevice" を使用し、 WiaItemPropertyId 列挙型の一部です。 そのスクリプト列挙の対応するメンバー名は、次の一覧の C/C++ 定数名の横にかっこで囲まれて表示されます。

注意

WIA では、Windows Vista 以降のカメラはサポートされていません。 これらのバージョンの Windows では、Windows Driver Development Kit (DDK) で説明されている Windows ポータブル デバイス (WPD) API を使用して、カメラからイメージを取得します。

 

定数/値 説明
WIA_DPC_PICTURES_TAKEN
CameraDevicePicturesTaken
 カメラが撮影した画像の数。 ミニドライバーは、このプロパティを作成して維持します。
種類: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE
WIA_DPC_PICTURES_REMAINING
CameraDevicePicturesRemaining
 現在のプロパティの設定に応じて取得できる画像の数。 これらの設定が変更され、変更がカメラ デバイスによって生成される画像のサイズに影響する場合、WIA ミニドライバーは残りの画像の数を更新する必要があります。 ミニドライバーは、このプロパティを作成して維持します。
種類: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE
WIA_DPC_EXPOSURE_MODE
CameraDeviceExposureMode
 カメラの現在の露出モードを示します。 アプリケーションはこのプロパティを変更して、カメラ デバイスの露出モードを制御します。
種類: VT_I4、Access: 読み取り/書き込み、有効な値: WIA_PROP_LIST
次の表に、このプロパティで有効な 7 つの定数を示します。
露出モード 説明
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 の設定は、より多くの露出を停止する 2 つ (センサーの 4 倍のエネルギー) に対応し、明るい画像が生成されます。 -1000 の設定は、1 回の停止が少ない露出 (センサーのエネルギーの 1/2) に対応し、暗い画像が生成されます。 設定値は、加法写真露光システム(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

レンズの開口に対応し、fストップ数を100でスケーリングした単位で表示します。 通常、このプロパティの設定は、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

次の表に、このプロパティで有効な 6 つの定数を示します。

フラッシュ モード 定義
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

次の表に、このプロパティで有効な 3 つの定数を示します。

フォーカス モード 説明
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

次の表に、このプロパティで有効な 2 つの定数を示します。

電源モード 説明
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 プロパティの有効な値の一覧との 1 対 1 の対応があります。 個々の幅と高さが直線的に設定され、互いに直交している場合は、範囲として表現できます。

種類: VT_I4、Access: 読み取り/書き込み、有効な値: WIA_PROP_LIST またはWIA_PROP_RANGE
WIA_DPC_PICT_HEIGHT
CameraDevicePictHeight

新しくキャプチャされた画像に使用する高さ (ピクセル単位)。 このプロパティの有効な値の一覧には、WIA_DPC_PICT_WIDTH プロパティの有効な値の一覧との 1 対 1 の対応付けがあります。 個々の幅と高さが直線的に設定され、互いに直交している場合は、範囲として表現できます。

種類: 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

次の表に、このプロパティで有効な 3 つの定数を示します。

効果モード 説明
EFFECTMODE_STANDARD カメラの標準モードで画像をキャプチャします。
EFFECTMODE_BW グレースケール イメージをキャプチャします。
EFFECTMODE_SEPIA セピア イメージをキャプチャします。

 
WIA_DPC_DIGITAL_ZOOM
CameraDeviceDigitalZoom

デジタル カメラで取得した画像の有効ズーム率を 10 倍に拡大します。 値 10 は、カメラによってキャプチャされる標準のシーン サイズであるデジタル ズーム (1X) がない場合に対応します。 値 20 は 2X ズームに対応し、標準シーン サイズの 4 分の 1 がカメラによってキャプチャされます。

型: 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

次の表に、このプロパティで有効な 3 つの定数を示します。

取り込みモード 説明
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を持っています。 このような場合でも、フレーム間の時間に関係なく、シリーズ内の最初のイメージがキャプチャされるまでの初期遅延として機能します。 事前キャプチャの遅延がない場合は、このプロパティを 0 に設定する必要があります。

型: VT_I4、Access: 読み取り/書き込み、有効な値: WIA_PROP_LIST またはWIA_PROP_RANGE
WIA_DPC_EXPOSURE_INDEX
CameraDeviceExposureIndex

デジタルカメラのフィルム速度設定のエミュレーションを可能にします。 設定は ISO の指定 (ASA/DIN) に対応しています。 通常、デバイスでは不連続の列挙値がサポートされますが、値の範囲を継続的に制御できます。 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

次の表に、このプロパティで有効な 2 つの定数を示します。

フォーカス測定モード 説明
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 について説明します。 このプロプロパーティで説明されている URL は、イメージまたはオブジェクトがデバイスから取得された後に、次のいずれかのシナリオに従ってアップロードできる URL です。

  • WIA アプリケーションはこのプロパティを読み取り、ユーザーが URL に画像を自動的にアップロードできるようにします。
  • アプリケーションによって URL が設定され、他のデバイス (キオスクなど) はこのプロパティを使用します。

Microsoft Windows では、単独では画像はアップロードされません。

型: VT_BSTR、Access: 読み取り/書き込み、有効な値: WIA_PROP_NONE
WIA_DPC_ARTIST
CameraDeviceArtist

デバイスの所有者 (現在のユーザー) の名前。 デバイスは、このプロパティを使用して、キャプチャするすべての EXIF イメージの Artist フィールドを設定します。

型: VT_BSTR、Access: 読み取り/書き込み、有効な値: WIA_PROP_NONE
WIA_DPC_COPYRIGHT_INFO
CameraDeviceCopyrightInfo

著作権通知。 デバイスは、このプロパティを使用して、キャプチャするすべての EXIF イメージの Copyright フィールドを設定します。

型: VT_BSTR、Access: 読み取り/書き込み、有効な値: WIA_PROP_NONE

要件

要件 値
サポートされている最小のクライアント
 Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003 [デスクトップ アプリのみ]
Header
Wiadef.h