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)