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。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|