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

KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE

KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE