KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE

手電筒筒模式會決定相機的閃爍如何在低光條件下使用。 閃爍會持續提供較低的濃度光源，讓自動焦點等作業有足夠的光線。

使用量摘要數據表

Get	Set	目標	屬性描述項類型	屬性值類型
Yes	Yes	篩選	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

屬性值 (作業數據) 包含 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)

另請參閱

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE