KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM
KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM 用來控制數位縮放。 它會定義在 KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY 列舉中，並用來取得和設定縮放比例，並從驅動程式取得縮放範圍。 在 Windows 10 中，此控件會擴充為也支援平滑縮放。
使用量摘要數據表
| 範圍 | 控制 | 類型 |
|---|---|---|
第 1 版 |
篩選 |
同步 |
下列旗標可以放在 KSCAMERA_EXTENDEDPROP_HEADER中。用來 控制平滑縮放與直接縮放的旗標欄位。 預設值是由驅動程式所定義。
#define KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT 0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_ZOOM_DIRECT 0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_ZOOM_SMOOTH 0x0000000000000002
如果驅動程式支援此控制件，它必須支援 KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT。
如果驅動程式不支援數位縮放，驅動程式就不應該實作此控件。
下表描述旗標功能。
| 旗標 | 描述 |
|---|---|
KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT |
這是必要功能。 指定時，驅動程式會決定是否應該套用直接縮放或平滑縮放至 VideoProc.Value.ul 中指定的目標縮放因數。 此旗標與 DIRECT 和 SMOOTH 旗標互斥。 |
KSCAMERA_EXTENDEDPROP_ZOOM_DIRECT |
這是必要功能。 指定時，驅動程式會儘快縮放至 VideoProc.Value.ul 中指定的目標縮放因數。 此旗標與 AUTO 和 SMOOTH 旗標互斥。 |
KSCAMERA_EXTENDEDPROP_ZOOM_SMOOTH |
這項功能是選擇性的。 指定時，驅動程式會以平滑的方式逐漸縮放至 VideoProc.Value.ul 中指定的目標縮放因數。 到達指定縮放因數的畫面格數目會由驅動程序決定。 此旗標與 AUTO 和 DIRECT 旗標互斥。 |
針對每個 GET 呼叫，驅動程式必須根據目前的組態或設定報告允許的目前縮放範圍。
下表包含使用 KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM 屬性時，KSCAMERA_EXTENDEDPROP_HEADER結構欄位的描述和需求。
| member | 描述 |
|---|---|
版本 |
這必須是 1， |
PinId |
這必須 KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) ， |
大小 |
這必須是sizeof (KSCAMERA_EXTENDEDPROP_HEADER) +sizeof (KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) ， |
結果 |
這表示上次 SET 作業的錯誤結果。 如果沒有進行 SET 作業，這必須是 0。 |
功能 |
必須是上面定義的支持旗標位 OR。 |
Flags |
這是讀取/寫入欄位。 這可以是上述任何一個支持的旗標。 |
下表包含 KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM 屬性KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING結構欄位的描述和需求。
| member | 描述 |
|---|---|
[模式] |
這是未使用的，而且必須是 0。 |
最小值/最大值/步驟 |
Min/Max/Step 包含數位相機驅動程式以 Q16 格式支援的縮放比例下限/最大值/增量。 驅動程式必須針對 GET 作業傳回這些值。 |
VideoProc |
針對 SET 作業，VideoProc.Value.ul 必須指定 Min/Max/Step 參數所描述範圍內的縮放比例。 針對 GET 作業，驅動程式必須傳回目前的縮放比例。 |
保留 |
這未使用。 驅動程式必須忽略此專案。 |
這個屬性控制件是同步且無法取消的。
規格需求
標頭 |
Ksmedia.h |