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)