共用方式為

KSPROPERTY_CAMERACONTROL_EXTENDED_RELATIVEPANELOPTIMIZATION

  • 發行項

KSPROPERTY_CAMERACONTROL_EXTENDED_RELATIVEPANELOPTIMIZATION 是一種屬性識別碼，用來通知驅動程式是否正向相機，相對於應用程式的作用中顯示。 設定新的 WinRT API 屬性 PanelBasedOptimizationControl.Panel 時，Windows 會設定 屬性。

您可以在 GitHub 上的 AVStream 數位相機範例驅動程式 中找到設定 KSProperty 控制項的範例。

使用量摘要資料表

Get 集合 目標 屬性描述項類型 屬性值類型
是 是 篩選 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中放置的旗標 。旗標 和 KSCAMERA_EXTENDEDPROP_HEADER。功能 欄位。

相對面板優化模式 描述
KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF 相機會使用正常作業模式
KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON 相機將使用相對於值欄位中所述位置的優化
KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_DYNAMIC 相機位置提示可以在串流時動態調整，而不會發生串流問題

KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION 一律是同步控制項。

任何應用程式都可以讀取屬性，但只有開啟相機供獨佔存取的應用程式可以寫入屬性值。

如果嘗試寫入屬性而不具有獨佔模式存取權，則會傳回適當的錯誤碼。

關於將此 DDI 對應至 PanelBasedOptimizationControl，使用 PanelBasedOptimizationControl 的應用程式會設定 Panel 值，Windows 會在內部用來程式設計承載 的KSCAMERA_EXTENDEDPROP_VALUE 欄位。

[ 功能 ] 和 [ 旗標] 欄位將由 Windows 控制。

如果驅動程式在相機裝置串流時收到 SET 作業，且未設定旗標 KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_DYNAMIC* ，驅動程式將會傳回以狀態為基礎的錯誤。

下表包含使用中繼資料控制項時 KSCAMERA_EXTENDEDPROP_HEADER 結構欄位的需求。

member 描述
版本 這必須是 1。
PinId KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
大小 這必須是 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE)
結果 指出最後一個 SET 作業的錯誤結果。 如果沒有進行 SET 作業，這必須是 0。
功能 必須是上述所支援KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_XXX旗標的位OR。
Flags 這是讀取/寫入欄位。 這可以是 上面定義的KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON 或 KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF 旗標。

如果在KSCAMERA_EXTENDEDPROP_HEADER的[旗標] 欄位中指定KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON，Value.ul欄位必須針對相機目前面向的相對方向指定 PLD。

這可以是 ACPI PLD 的任何列舉值，但最常是 Front、 Back 或 Unknown。

如果指定 了KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF ，則會忽略 SET 作業的 [值 ] 欄位。

針對 GET 作業，驅動程式必須傳回相機目前為程式設計的方向。

如果指定 KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF ，或未設定任何值，則必須傳回裝置的預設 PLD。

如果指定 KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON ，則必須傳回最近設定的值。

規格需求

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