KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE
焦點模式屬性會控制相機的自動、手動和預設焦點模式。
使用量摘要數據表
| Get | Set | 目標 | 屬性描述項類型 | 屬性值類型 |
|---|---|---|---|---|
Yes |
Yes |
篩選 |
) 作業數據 (屬性值包含 KSCAMERA_EXTENDEDPROP_HEADER 結構和 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 結構。
屬性數據大小總計為 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) 。 KSCAMERA_EXTENDEDPROP_HEADER的 Size 成員會設定為此屬性數據大小總計。
KSCAMERA_EXTENDEDPROP_HEADER的功能成員包含下列一或多個視訊處理選項的位 OR 組合。
| 處理和焦點模式 | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO | 數位相機驅動程式會針對視訊使用自己的處理邏輯。 |
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL | 數位相機驅動程式會使用預設處理方法或溫度型方法。 |
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK | 目前的視訊處理方法已鎖定。 |
| KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS | 沒有聚合焦點集。 |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_MACRO | 宏範圍焦點聚合。 |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_NORMAL | 一般範圍焦點聚合。 |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE | 全範圍焦點聚合。 |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_INFINITY | 無限範圍焦點聚合。 |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_HYPERFOCAL | 超focal 範圍。 |
KSCAMERA_EXTENDEDPROP_HEADER的 Flags 成員包含目前為相機設定的視訊處理旗標。 如果KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO設定可以與KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK結合。
這個屬性控件是異步且可取消的。
備註
處理模式
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO
這個旗標表示自動焦點作業在觸發完成事件時已交集。 完成時，而且當這個旗標未與KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK結合時，焦點可能會分叉，而相機驅動程式可能會繼續嘗試聚合。 如果包含KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK旗標，焦點會鎖定到第一個聚合，而且在收到新的焦點命令之前不會變更。
鎖定，而不結合自動模式，相機驅動程式應該將已鎖定的控件視為無作業。 鎖定與自動模式結合時，已鎖定的控件應該觸發新的聚合。
此旗標與KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL和KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS旗標互斥。
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL
手動指出此視訊處理會提供特定值。 特定值會提供給驅動程式。
此旗標不得與KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO、KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK或KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS結合。
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK
設定此旗標時沒有對應的KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO旗標時，相機驅動程式預期會鎖定目前的焦點狀態，並在鎖定焦點後觸發完成事件。 在收到新的焦點命令之前，數位相機驅動程式不得改變焦點狀態。 如果KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO結合此旗標，數位相機驅動程式會交集於自動焦點，並將焦點鎖定到該聚合點，然後觸發完成事件。 這個旗標不得與KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS或KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL結合。
除非與KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO結合，否則此旗標可能不會以焦點控件的範圍旗標指定。 在此情況下，會使用範圍旗標執行焦點，以判斷嘗試自動焦點掃描的位置。 然後，在聚合時，焦點設定會鎖定並引發完成事件。
KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS
這個旗標表示焦點是連續的。 在此情況下，焦點控制沒有單一聚合點。 驅動程序必須接受此要求，並立即完成異步操作。
此旗標不得與KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO、KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK或KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL結合。
所有驅動程式都需要此模式。
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_MACRO
此旗標表示應該針對宏範圍執行焦點聚合。 確切的焦點範圍是由驅動程序決定。 此旗標可以與KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO和KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS結合。
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_NORMAL
此旗標表示應該針對一般範圍執行焦點聚合。 確切的焦點範圍是由驅動程序決定。 此旗標可以與KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO和KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS結合。
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE
此旗標表示應該針對完整範圍執行焦點聚合。 確切的焦點範圍是由驅動程序決定。 此旗標可以與KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO和KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS結合。
所有驅動程式都需要此模式。
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_INFINITY
這個旗標表示應該針對無限範圍執行焦點聚合。 確切的焦點範圍是由驅動程序決定。 此旗標可以與KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO和KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS結合。
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_HYPERFOCAL
此旗標表示應該針對超focal 範圍執行焦點聚合。 確切的焦點範圍是由驅動程序決定。 此旗標可以與KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO和KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS結合。
取得屬性
回應KSPROPERTY_TYPE_GET要求時，驅動程式會將 KSCAMERA_EXTENDEDPROP_HEADER 的成員設定為下列專案。
| 成員 | 值 |
|---|---|
| 版本 | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) 。 |
| 大小 | sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) |
| 結果 | 0 |
| 功能 | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL |KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE | (支援視訊處理和焦點模式) |
| Flags | 目前的視訊處理和焦點模式。 |
如果沒有先前設定的焦點範圍旗標，驅動程式會將 Flags 設定為KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE以及預設) KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO (。 遵循KSCAMERA_EXTENDEDPROP_HEADER KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING結構的成員會根據焦點模式的需求來設定。
當模式KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO時， VideoProp.Value.ull 值必須包含目前的曝光設定。
設定屬性
設定屬性時，KSPROPERTY_TYPE_SET要求，KSCAMERA_EXTENDEDPROP_HEADER的 Flags 成員將會包含要設定的焦點模式。 當 Flags 包含KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO、KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS旗標時，必須忽略 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING的 VideoProc.Value 成員。
規格需求
版本 |
從 Windows 8.1 開始提供。 |
標頭 |
Ksmedia.h (包含 Ksmedia.h) |