KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE
手電筒筒模式會決定相機的閃爍如何在低光條件下使用。 閃爍會持續提供較低的濃度光源，讓自動焦點等作業有足夠的光線。
使用量摘要數據表
| Get | Set | 目標 | 屬性描述項類型 | 屬性值類型 |
|---|---|---|---|---|
Yes |
Yes |
篩選 |
屬性值 (作業數據) 包含 KSCAMERA_EXTENDEDPROP_HEADER 結構和 KSCAMERA_EXTENDEDPROP_VALUE 結構。
屬性數據大小總計為 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) 。 KSCAMERA_EXTENDEDPROP_HEADER的 Size 成員會設定為此屬性數據大小總計。
KSCAMERA_EXTENDEDPROP_HEADER的功能成員包含驅動程序支援的一或多個下列手電筒筒模式的位 OR 組合。
| 手電筒筒模式 | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF | Torchlight 已關閉。 |
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON | Light 位於預設強度層級。 |
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER | 手電筒位於特定的電源等級。 |
KSCAMERA_EXTENDEDPROP_HEADER的 Flags 成員包含相機目前設定的手電筒筒模式。 相機的默認手電筒模式是KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF，而且驅動程式必須支援這個手電筒筒模式。
這個屬性控制件是同步且無法取消的。
備註
取得屬性
回應KSPROPERTY_TYPE_GET要求時，驅動程式會將 KSCAMERA_EXTENDEDPROP_HEADER 的成員設定為下列專案。
| 成員 | 值 |
|---|---|
| 版本 | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) 。 |
| 大小 | sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) |
| 結果 | 0 |
| 功能 | 支援手電筒筒模式值。 |
| Flags | 目前的手電筒筒模式值設定只會 (一個值) 。 |
當手電筒筒模式KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER時，KSCAMERA_EXTENDEDPROP_VALUE的 Value.ull 成員包含介於 0 - 100 之間的強度等級值。 0 的強度表示最低層級，而 100 的強度表示最大強度等級。
如果先前未設定場景模式， 則 Flags 會設定為 KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF (默认) 。
設定屬性
設定屬性時，KSPROPERTY_TYPE_SET要求，KSCAMERA_EXTENDEDPROP_HEADER的 Flags 成員將會包含要設定的手電筒筒模式。 如果 Flags 是KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER，KSCAMERA_EXTENDEDPROP_VALUE的Value.ull 成員將會包含要設定的強度層級。
規格需求
版本 |
從 Windows 8.1 開始提供。 |
標頭 |
Ksmedia.h (包含 Ksmedia.h) |