KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING構造体 (ksmedia.h)

[アーティクル]
03/30/2024

KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTINGは、ホワイトバランス、露出モード、フォーカスモードに関連するビデオ処理設定のプロパティペイロード構造です。

構文

typedef struct tagKSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING {
  ULONG                       Mode;
  LONG                        Min;
  LONG                        Max;
  LONG                        Step;
  KSCAMERA_EXTENDEDPROP_VALUE VideoProc;
  ULONGLONG                   Reserved;
} KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING, *PKSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING;

メンバー

Mode

ビデオ処理モードの種類。現在、このメンバーはホワイトバランスを制御するために使用されます。 Mode に指定できる値は次のとおりです。

値	説明
KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE	図の温度値は、ケルビン度のホワイトバランスを設定するために使用されます。
KSCAMERA_EXTENDEDPROP_WHITEBALANCE_PRESET	ホワイトバランスの設定は、 VideoProc で指定されたプリセット値です。

このメンバーは、 KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE および KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODEには使用されません。このような場合は、0 に設定する必要があります。

Min

VideoProc の設定の最小値。

Max

VideoProc の設定の最大値。

Step

Mode が KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE に設定されている場合の VideoProc の設定に対する増分値 (該当する場合)。

または

露出を設定する場合の VideoProc の設定に対する値の増分 (該当する場合) は、KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUALで手動で設定されます。

VideoProc

KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE プロパティを使用して Mode をKSCAMERA_EXTENDEDPROP_WHITEBALANCE_PRESETに設定すると、VideoProc.Value.ul 値は次のいずれかになります。

値	説明
KSCAMERA_EXTENDEDPROP_WBPRESET_CLOUDY	白濁条件のホワイトバランスプリセット。
KSCAMERA_EXTENDEDPROP_WBPRESET_DAYLIGHT	白昼光用のホワイトバランスプリセット。
KSCAMERA_EXTENDEDPROP_WBPRESET_FLASH	フラッシュ照明を補正するホワイトバランスプリセット。
KSCAMERA_EXTENDEDPROP_WBPRESET_FLUORESCENT	蛍光照明を補正するホワイトバランスプリセット。
KSCAMERA_EXTENDEDPROP_WBPRESET_TUNGSTEN	ホワイトバランスは、タングステン発光照明を補うためにプリセット。
KSCAMERA_EXTENDEDPROP_WBPRESET_CANDLELIGHT	キャンドルライトの照明を補正するホワイトバランスプリセット。

KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE プロパティを使用して Mode をKSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATUREに設定すると、VideoProc.Value.ul 値はケルビン度の温度値になります。

KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE プロパティを使用して、手動で露出を設定する場合、KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL、VideoProc.Value.ul 値は 100 ナノ秒単位の露光時間です。

このメンバーには、KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE プロパティを使用して、手動フォーカスモードの焦点距離の値が含KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL。

Reserved

予約済み。