KSPROPERTY_CAMERACONTROL_EXTENDED_FLASHMODE (一般和序列)

flash 屬性控件會設定相機一般和序列相片模式的閃爍模式作業。

使用量摘要數據表

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_FLASH_OFF	快閃已關閉。
KSCAMERA_EXTENDEDPROP_FLASH_ON	Flash 位於預設強度層級。
KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER	Flash 位於特定電源等級。
KSCAMERA_EXTENDEDPROP_FLASH_AUTO	根據光源條件自動閃爍。
KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER	Flash 會根據特定電源等級的光源條件自動進行。

除了KSCAMERA_EXTENDEDPROP_FLASH_OFF以外，下列功能旗標可以與先前的快閃設定結合。

Flash 功能	Description
KSCAMERA_EXTENDEDPROP_FLASH_REDEYEREDUCTION	啟用重做縮小功能。 此旗標可以與任何其他設定結合。
KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASH	僅針對一個觸發程式設定快閃。 當相機不在相片序列模式中時，會忽略此功能。
KSCAMERA_EXTENDEDPROP_FLASH_MULTIFLASHSUPPORTED	設定快閃以在每個序列畫面格上觸發。 當相機不在相片序列模式中時，會忽略此功能。

KSCAMERA_EXTENDEDPROP_HEADER的 Flags 成員包含目前為相機設定的閃爍模式。

相機的默認閃爍模式是KSCAMERA_EXTENDEDPROP_FLASH_OFF。 如果相機支持閃爍、KSCAMERA_EXTENDEDPROP_FLASH_OFF、KSCAMERA_EXTENDEDPROP_FLASH_ON和KSCAMERA_EXTENDEDPROP_FLASH_AUTO是必要模式。 KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER和KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER模式是選擇性的。

如果相機支援相片順序模式，則需要 flash 控件屬性，且支援KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASH。

這個屬性控制件是同步且無法取消的。

備註

取得屬性

回應KSPROPERTY_TYPE_GET要求時，驅動程式會將 KSCAMERA_EXTENDEDPROP_HEADER 的成員設定為下列專案。

成員	值
版本	1
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
大小	sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE)
結果	0
功能	支援的快閃模式值
Flags	(目前的快閃模式值設定) | (快閃功能旗標)

當手電筒筒模式KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER或KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER時，KSCAMERA_EXTENDEDPROP_VALUE的 Value.ull 成員包含介於 0 - 100 之間的強度等級值。 0 的強度表示最低層級，而 100 的強度表示最大強度等級。 如果未設定可調整的電源旗標，則會在 Value.ull 中傳回標準化強度設定的值。

如果先前未設定任何快閃模式， 則 Flags 會設定為預設) KSCAMERA_EXTENDEDPROP_FLASH_OFF (。

設定屬性

設定屬性時，KSPROPERTY_TYPE_SET要求，KSCAMERA_EXTENDEDPROP_HEADER的 Flags 成員將會包含要設定的手電筒筒模式。 如果 Flags 是KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER或KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER，KSCAMERA_EXTENDEDPROP_VALUE的Value.ull 成員將會包含要設定的強度等級。

規格需求

版本：從 Windows 8.1 開始提供

頭： Ksmedia.h (包含 Ksmedia.h)

另請參閱

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE