KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 結構 (ksmedia.h)
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 的可能值如下。
| 值 | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE | 圖片溫度值用來設定 Kelvin 的白色平衡度。 |
| 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 中的設定值遞增。
-或-
在視訊 Proc 中設定曝光手動設定時，值中的遞增值會以KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL設定。
VideoProc
當 Mode 設定為 KSCAMERA_EXTENDEDPROP_WHITEBALANCE_PRESET 時，使用 KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE 屬性時，VideoProc.Value.ul 值會是下列其中一項。
| 值 | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_WBPRESET_CLOUDY | 雲端條件的白色平衡預設值。 |
| KSCAMERA_EXTENDEDPROP_WBPRESET_DAYLIGHT | 雲端日光節約的白色平衡預設值。 |
| KSCAMERA_EXTENDEDPROP_WBPRESET_FLASH | 白色平衡預設可補償閃爍光源。 |
| KSCAMERA_EXTENDEDPROP_WBPRESET_FLUORESCENT | 白色平衡預設可補償光源。 |
| KSCAMERA_EXTENDEDPROP_WBPRESET_TUNGSTEN | 白色平衡預設，可補償發出亮起的光源。 |
| KSCAMERA_EXTENDEDPROP_WBPRESET_CANDLELIGHT | 白色平衡預設可補償光線光源。 |
當 Mode 設定為 KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE 時，使用 KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE 屬性，VideoProc.Value.ul 值會是 Kelvin 度的溫度值。
使用 KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE 屬性，用於手動設定曝光時，KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL VideoProc.Value.ul 值是 100 奈秒單位的曝光時間。
使用 KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE 屬性，這個成員包含手動焦點模式的焦點長度值，KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL。
Reserved
保留的。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 8.1 開始提供。 |
| 標頭 | ksmedia.h (包含 Ksmedia.h) |
另請參閱
KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE