KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOSTABILIZATION

這個擴充屬性控件可用來控制 driver\MFT0 中的數位視訊防震。

使用量摘要表格

範圍	控制	類型
第 1 版	Pin	同步

下列旗標可以放在KSCAMERA_EXTENDEDPROP_HEADER中。旗標字段旗標，以控制 driver\MFT0 中的數位視訊防震。 根據預設，驅動程式應該會關閉視訊防震。

#define KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_OFF       0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_ON        0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_AUTO      0x0000000000000002

如果驅動程式不支援數位視訊防震，驅動程式不應該實作此控件。

如果驅動程式支援此控件，它必須支援 VIDEOSTABILIZATION_ON\OFF。

當視訊針腳處於高於KSSTATE_STOP狀態的任何狀態時，此控件的SET呼叫就沒有任何作用。 如果視訊釘選不在停止狀態，並傳回STATUS_INVALID_DEVICE_STATE，驅動程式應該拒絕收到的SET呼叫。 在 GET 呼叫中，驅動程式應該會傳回 [旗標] 字段中目前的設定。

當此控制項用於設定檔的內容時，配置檔應做為品質模式驅動程式的提示。 當視訊防震根據選取的配置檔開啟時，驅動程式可以決定是否要針對低延遲或高品質影片進行優化，例如視訊會議或高品質的視訊錄製。

注意

PROPSETID_VIDCAP_CAMERACONTROL_VIDEO_STABILIZATION即將淘汰 Windows 10。

下表描述旗標功能。

旗標	描述
KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_OFF	這是必要功能。 指定時，數字視訊防震會在 driver\MFT0 中停用。
KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_ON	這是必要功能。 指定時，數字視訊防震會在 driver\MFT0 中啟用，而預設的過度掃描填補設定則高於驅動程式。 此旗標與 AUTO 和 OFF 旗標互斥。
KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_AUTO	這項功能是選擇性的。 指定時，支援這類功能的驅動程式會決定是否應該執行視訊防震，以及根據場景分析和擷取案例套用多少防震。 此旗標與 ON 和 OFF 旗標互斥。

注意

視實作而定，過度掃描的緩衝區可由驅動程序內部或管線配置。

如果驅動程式要配置過度掃描的緩衝區，驅動程式應該同時公告一般媒體類型和過度掃描的媒體類型。 MFT0 應該公告一般媒體類型。 在 MFT0 的輸出媒體類型上設定一般媒體類型時，如果開啟視訊防震，MFT0 應該從驅動程式公告媒體類型選取對應的過度掃描媒體類型作為其輸入媒體類型。 如果關閉視訊防震，MFT0 應該選取一般媒體類型作為其輸入媒體類型。 如果過度掃描的媒體類型設定為開啟視訊防震時，MFT0 應該傳回MF_E_INVALIDMEDIATYPE。

如果驅動程式配置過度掃描的緩衝區，則驅動程式和 MFT0 都應該公告一般媒體類型。 MFT0 應該為其輸入媒體類型和輸出媒體類型設定一般媒體類型。

為了支援以效果為基礎的視訊防震 (，亦即，無論在驅動程式或 MFT0) 中，驅動程式和 MFT0 都必須另外公告過度掃描的媒體類型。 在此情況下，驅動程式和 MFT0 會公開一般和過度掃描的媒體類型。 下列規則適用於確保效果型和驅動程式\MFT0 型視訊防震都能正常運作。

• 如果在驅動程式\MFT0 型視訊防震開啟時，過度掃描的媒體類型設定為 MFT0 輸出媒體類型，MFT0 應該傳回MF_E_INVALIDMEDIATYPE。

• 如果一般媒體類型設定為 MFT0 輸出媒體類型，則如果效果型視訊防震只能採用過度掃描的媒體類型，應用程式應該會在嘗試開啟效果型視訊防震時傳回錯誤。

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

member	描述
版本	這必須是 1。
PinId	必須是與視訊釘選相關聯的 Pin 識別碼。
大小	這必須是 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) 。
結果	指出最後一個SET作業的錯誤結果。 如果未執行 SET 作業，這必須是 0。
功能	這必須是上述所定義之支援的KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_XXX旗標的位 OR。
Flags	這是讀取/寫入欄位。 這可以是上述任何一個KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_XXX旗標。

規格需求

標頭

Ksmedia.h