KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT (应用程序效能策略)

相機驅動程式可以根據應用程式所提供的提示，將擷取作業優化。 此屬性會通知驅動程式根據可能最常使用的作業來設定其效能策略。 例如，針對相片優化時，相機驅動程式可能會設計感測器，將感測器曝光速度和解析度優化，以降低相片擷取觸發程式到影像擷取的延遲。 同樣地，針對視訊優化時，相機驅動程式可能會針對較高的幀速率來設計感測器，但解析度較低。

使用量摘要表格

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_OPTIMIZATION_PHOTO	相機作業已針對相片優化
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO	相機作業已針對視訊優化

KSCAMERA_EXTENDEDPROP_HEADER的 Flags 成員包含相機目前設定的優化， (一個值) 。

默認優化類型KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO。 如果相機驅動程式支援這個屬性，則必須支援這兩種優化類型。

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

備註

優化模式

KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO

所有相機驅動程式都必須處於此模式，直到明確通知使用KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO模式為止。 此模式的目的是要針對相片作業優化相機硬體。 視訊作業仍必須在此模式中運作。

KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO

此模式表示相機可能用於視訊作業。 相機驅動程式應針對此模式的視訊作業優化硬體。 相片作業必須正常運作，但有資源使用量優先順序適用於視訊作業。

取得屬性

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

成員	值
版本	1
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
大小	sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE)
結果	0
功能	支援的優化值
Flags	目前的優化值設定

如果先前未設定任何優化模式，則驅動程式 會將 Flags 設定為KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO (默认) 。

設定屬性

設定屬性時，KSPROPERTY_TYPE_SET要求，KSCAMERA_EXTENDEDPROP_HEADER的 Flags 成員將包含要設定的優化模式。

規格需求

版本：從 Windows 8.1 開始提供

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

另請參閱

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE