KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE
白平衡模式屬性會指定是否要改用白平衡或手動溫度值的自動處理。
使用量摘要數據表
| 取得 Yammer | 設定 | Target | 屬性描述項類型 | 屬性值類型 |
|---|---|---|---|---|
| Yes | .是 | 篩選器 | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
屬性值（作業數據）包含KSCAMERA_EXTENDEDPROP_HEADER結構和KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING結構。
屬性數據大小總計為 sizeof（KSCAMERA_EXTENDEDPROP_HEADER） + sizeof（KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING）。 KSCAMERA_EXTENDEDPROP_HEADER的 Size 成員會設定為這個屬性數據大小總計。
KSCAMERA_EXTENDEDPROP_HEADER的功能成員包含下列一或多個視訊處理選項的位 OR 組合。
| 處理模式 | 描述 |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO | 相機 驅動程式會針對視訊使用自己的處理邏輯。 |
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL | 相機 驅動程式會使用預設處理方法或以溫度為基礎的方法。 |
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK | 目前的視訊處理方法已鎖定。 |
KSCAMERA_EXTENDEDPROP_HEADER的 Flags 成員包含相機目前設定的視訊處理旗標。 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO設定可以與KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK結合。
這個屬性控件是異步且無法取消的。
備註
處理模式
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO
這表示支援自動處理。 驅動程式會使用其內部邏輯來優化視訊處理。 針對KSPROPERTY_TYPE_GET要求，KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING的VideoProc成員必須包含目前驅動程式決定的視訊處理值。 在白平衡的情況下，它必須包含開爾文目前的溫度。 自動 作業會忽略Mode 成員。
此旗標可以與 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 合併為位 OR 值。 鎖定時，相機驅動程式的預期行為是聚合在白色平衡上，並將白色平衡值鎖定為聚合值，直到收到新的白色平衡命令，才會再次嘗試自動白平衡。
鎖定，而不結合自動模式，相機驅動程式應該將已經鎖定的控件視為無作業。 鎖定與自動模式結合時，已鎖定的控件應該觸發新的聚合。
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL
手動指出，針對此影片處理，會提供特定值。 在白平衡的情況下，如果KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING的Mode成員指出KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE，VideoProc.Value.ul會包含溫度值以 Kelvin 度為單位。
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 鎖定選項旗標表示目前的視訊處理鎖定至目前已進行程序設計的任何值。 例如，應用程式可能會要求自動模式，直到決定特定的白平衡為止，此時應用程式會決定使用相同的白色平衡設定來拍攝一系列相片。 在這種情況下，應用程式可以指定 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 旗標。 相機驅動程式將確保白平衡資訊不會在不同的相片之間變更。
取得屬性
回應KSPROPERTY_TYPE_GET要求時，驅動程式會將KSCAMERA_EXTENDEDPROP_HEADER的成員設定為下列專案。
| member | 值 |
|---|---|
| 版本 | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE （0xFFFFFFFF） |
| 大小 | sizeof（KSCAMERA_EXTENDEDPROP_HEADER） + sizeof（KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING） |
| 結果 | 0 |
| 功能 | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL OR'd 搭配使用 （支援視訊處理模式） |
| 旗標 | 目前的視訊處理模式。 |
如果先前未設定白平衡模式，則驅動程式會將 Flags 設定為 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO （預設值）。 遵循KSCAMERA_EXTENDEDPROP_HEADER KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING結構的成員會根據處理模式的需求來設定。
設定屬性
設定屬性時，KSPROPERTY_TYPE_SET要求，KSCAMERA_EXTENDEDPROP_HEADER的 Flags 成員將會包含要設定的白平衡模式。 當 Flags 包含KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO模式旗標時，必須忽略KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING的 VideoProc.Value 成員。
需求
版本： 從 Windows 8.1 開始提供
標頭： ksmedia.h （包括 Ksmedia.h）