IPropertySetter 介面

[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

注意

[已被取代。 此 API 可能會從未來的 Windows 版本中移除。]

 

介面 IPropertySetter 會在 DirectShow Editing Services (DES) 中設定效果或轉換的屬性。

若要使用此介面，請建立屬性 setter 物件的實例 (CLSID_PropertySetter) ，並藉由呼叫 IAMTimelineObj：：SetPropertySetter 方法將它與效果或轉換產生關聯。 如需詳細資訊，請參閱 使用效果和轉換。

通常應用程式只需要呼叫 IPropertySetter：：ClearProps 方法來清除現有的屬性，以及 IPropertySetter：：AddProp 方法才能新增屬性。 這個介面上的其他方法是由其他 DES 元件呼叫。

成員

IPropertySetter介面繼承自IUnknown介面。 IPropertySetter 也有下列類型的成員：

• 方法

方法

IPropertySetter介面具有這些方法。

方法	Description
AddProp	將屬性加入至屬性 setter，並具有一組時間值陣列，定義某個時間範圍內的屬性值。
ClearProps	清除屬性 setter 中的所有屬性資料。
CloneProps	從這個屬性 setter 複製一組屬性，並將其新增至新的屬性 setter。
FreeProps	釋放 IPropertySetter：：GetProps 方法所配置的資源。
GetProps	擷取這個 物件上設定的屬性，其對應的值。
LoadFromBlob	從持續性格式載入屬性資料。
LoadXML	載入以可擴展標記語言表示的屬性資料， (XML) 。
PrintXML	將屬性資料轉換成 XML 字串。
SaveToBlob	將屬性資料儲存至持續性格式。
SetProps	將目標物件的屬性設定為指定時間的適當狀態。

 

備註

注意

標頭檔 Qedit.h 與 7 版之後的 Direct3D 標頭不相容。

 

注意

若要取得 Qedit.h，請下載Windows Vista Microsoft Windows SDK Update 和 .NET Framework 3.0。 Qedit.h 不適用於 Windows 7 和 .NET Framework 3.5 Service Pack 1 的 Microsoft Windows SDK。

 

規格需求

需求	值
標頭	Qedit.h
程式庫	Strmiids.lib