共用方式為

KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT (扩充的硬件优化)

  • 發行項

KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT可用來控制相片擷取與視訊擷取的主要使用案例。 在 Windows 10 中，此控件會延伸以支援擴充的硬體優化提示。

使用量摘要表格

範圍 控制 類型
第 1 版 篩選 同步

下列旗標可以放在KSCAMERA_EXTENDEDPROP_HEADER中。將欄位標示為驅動程式中的硬體優化提示。

#define KSCAMERA_EXTENDEDPROP_OPTIMIZATION_DEFAULT      0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO        0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO        0x0000000000000002
#define KSCAMERA_EXTENDEDPROP_OPTIMIZATION_QUALITY      0x0000000000000004
#define KSCAMERA_EXTENDEDPROP_OPTIMIZATION_LATENCY      0x0000000000000008
#define KSCAMERA_EXTENDEDPROP_OPTIMIZATION_POWER        0x0000000000000010

PHOTO 和 VIDEO 提示將繼續用來指定主要使用案例。

針對 Windows 10，其他位旗標可協助取捨驅動程序的品質、速度和耗電量。 根據預設，驅動程式應該會有KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO。

如果驅動程式支援此控制件，它必須支援KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO和KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO。

如果驅動程式不支援優化提示，驅動程式不應該實作此控件。

下表描述旗標功能。

旗標 描述
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_DEFAULT 這是必要功能。 指定時，驅動程式應該清除先前在驅動程式上設定的提示，並套用驅動程式的預設電源、品質、延遲取捨。
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO 這是必要功能。 指定時，主要使用案例是相片擷取，而驅動程式應優先處理相片擷取與視訊錄製的優先順序。 當預覽釘選處於停止狀態時，可以指定此旗標，以選取感測器模式，以取得相片品質，或只在視訊錄製期間處於相片擷取的執行狀態。 在視訊錄製期間針對相片擷取指定時，可接受視訊串流中的問題，以取得更好的相片品質。 此旗標與 VIDEO 旗標互斥，可與任何一或兩個 QUALITY、LATENCY 和 POWER 旗標搭配使用。
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO 這是必要功能。 指定時，主要使用案例是視訊擷取，而驅動程式應優先處理視訊錄製的優先順序高於相片擷取。 當預覽釘選處於停止狀態時，可以指定此旗標，以選取感測器模式，而偏好錄製視訊，或只在視訊錄製期間處於相片擷取的執行狀態。 在視訊錄製期間指定相片擷取時，不允許視訊串流中的問題。 此旗標與 PHOTO 旗標互斥，可與任何一或兩個 QUALITY、LATENCY 和 POWER 旗標搭配使用。
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_QUALITY 這項功能是選擇性的。 指定時，驅動程式應優化相片擷取的影像品質，以及視訊錄製的視訊品質。 您可以在相片擷取 (之前指定此旗標，包括一般相片、VPS 和 PS，而不需記錄畫面格) 和/或視訊錄製開始，或釘選處於停止狀態時。 此旗標可以搭配 PHOTO 旗標使用，或搭配 LATENCY 或 POWER 旗標搭配 VIDEO 旗標使用。
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_LATENCY 這項功能是選擇性的。 指定時，驅動程式應優化相片擷取和視訊錄製的速度和延遲。 您可以在相片擷取 (之前指定此旗標，包括一般相片、VPS 和 PS，而不需記錄畫面) 和\或視訊錄製開始，或釘選處於停止狀態時。 此旗標可以搭配 PHOTO 旗標使用，或搭配 QUALITY 或 POWER 旗標搭配 VIDEO 旗標使用。
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_POWER 這項功能是選擇性的。 指定時，驅動程式應優化相片擷取和視訊錄製的耗電量。 您可以在相片擷取 (之前指定此旗標，包括一般相片、VPS 和 PS，而不需記錄) 和/或視訊錄製，或釘選處於停止狀態時。 此旗標可與 QUALITY 或 LATENCY 旗標搭配使用，以及 VIDEO 旗標。

下表包含使用 控件時 ，KSCAMERA_EXTENDEDPROP_HEADER 結構欄位的描述和需求。

成員 值
版本 1
PinId KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
大小 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE)
結果 指出最後一個SET作業的錯誤結果。 如果未執行 SET 作業，這必須是 0。
功能 必須是支援的 KSCAMERA_EXTENDEDPROP_OPTIMIZATION_* 旗標的位 OR，如上面所定義。
Flags 這是讀取/寫入欄位。 這可以是上述所定義KSCAMERA_EXTENDEDPROP_OPTIMIZATION_* 旗標的任何有效組合。

備註

使用優化提示時，請記住下列專案：

  • QUALITY/LATENCY/POWER 和 PHOTO/VIDEO 是兩組獨立的提示。 它們可以同時指定，或在不同的時間獨立指定。 設定品質/延遲/POWER 不會覆寫 PHOTO/VIDEO，反之亦然。 在不同的時間指定時，驅動程式應該會在 GET 呼叫中傳回這兩組提示的目前設定。

  • 針對 QUALITY/LATENCY/POWER，當設定提示時，驅動程式應該在其條件約束內優化。 如果沒有可用的優化，驅動程序應該忽略提示。

  • 當視訊使用案例同時指定兩個提示時，每個提示的優化可能會小於只指定一個提示時。 具體而言：

    • 當同時指定 QUALITY 或 POWER 時，延遲優先於品質或 POWER。 在這種情況下，品質可能小於只指定 QUALITY 時，而且耗電量可能高於只指定 POWER 時。

    • 同時指定 QUALITY 和 POWER 時，品質可能小於只指定 QUALITY 時，而且耗電量可能高於只指定 POWER 時。

  • 優化提示只會作為驅動程式的提示，以在應用程式所指定的擷取案例條件約束內，協助處理 3A、ISP 處理、感測器選取等的處理取捨。 應用程式開發人員務必選取及設定特定擷取案例最適合的控件和 API，以達到最佳結果。 否則，優化提示可能會降低效果。 例如，針對高品質的相片擷取，應該使用 VPS 或 LowLagPhoto/TakePhoto，而不是在特定 IHV 平臺上使用 PS，以使用 QUALITY 提示。 同樣地，如果需要較低的延遲或耗電量，應該停用視訊防震。

  • 如果在每個功能旗標下指定的專案以外的時間/狀態收到，則應該忽略優化提示。

在驅動程式上同時啟用視訊防震控制時， (ON 或 AUTO) ：

  • 驅動程式可能會套用最低積極視訊防震，其中包括低延遲和/或低電源防震演算法，以減少延遲和/或 POWER 提示時的處理延遲和/或耗電量。 當視訊防震設定為 AUTO 時，驅動程式可能會關閉視訊防震，以進一步降低延遲和/或耗電量。

  • 如果已設定 QUALITY 提示，驅動程式可能會套用最高的積極視訊防震，以改善視訊品質。

規格需求

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