IWMProfile 介面

[與此頁面相關聯的功能 Windows Media Format 11 SDK是舊版功能。 來源讀取器和接收寫入器已取代它。 來源讀取器和接收寫入器已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用來源讀取器和接收寫入器，而不是Windows Media Format 11 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]

IWMProfile介面是設定檔物件的主要介面。 設定檔物件是用來設定自訂設定檔。 您可以使用 IWMProfile 來建立、刪除或修改資料流程組態物件和相互排除物件。 您也可以設定和擷取設定檔的一般資訊。 若要存取設定檔物件的所有功能，您應該使用繼承自IWMProfile 和 IWMProfile2的IWMProfile3。

IWMProfile 也可以透過讀取器物件存取，您可以在其中使用它來取得讀取器中載入之檔案資料流程的相關資訊。 從讀取器存取 IWMProfile 時，您可以對設定檔進行變更，但無法將任何變更儲存至檔案。 使用現有檔案的設定檔作為新設定檔的基礎通常很方便。 同步讀取器以與讀取器相同的方式支援 IWMProfile 。

透過讀取器或同步讀取器取得的設定檔資訊不是來自 .prx 檔案。 讀取器會使用 ASF 檔案中的資訊來組合資料流程組態。 因此，某些設定檔資訊，例如名稱和描述，無法透過讀取器取得。

有數種方式可以取得 IWMProfile 介面的指標。 設定檔管理員有方法來建立新的設定檔，以及存取現有的設定檔。 所有這些方法都會設定 IWMProfile 指標。 讀取檔案時，可以呼叫任何讀取器介面的QueryInterface方法來取得IWMProfile的指標。 同樣地，同步讀取器物件的任何介面都可以取得具有 QueryInterfaceIWMProfile3呼叫的指標。

成員

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

• 方法

方法

IWMProfile介面具有這些方法。

方法	Description
AddMutualExclusion	將相互排除物件新增至設定檔。
AddStream	將資料流程新增至設定檔。
CreateNewMutualExclusion	建立設定檔的互斥物件。
CreateNewStream	建立設定檔的資料流程組態物件。
GetDescription	擷取設定檔的描述。
GetMutualExclusion	從設定檔擷取互斥物件。
GetMutualExclusionCount	擷取設定檔中的互斥物件數目。
GetName	擷取設定檔的名稱。
GetStream	使用索引編號從設定檔擷取資料流程。
GetStreamByNumber	使用設定檔中的資料流程數目擷取資料流程。
GetStreamCount	擷取設定檔中的資料流程數目。
GetVersion	擷取設定檔中的 Microsoft Windows 媒體服務版本號碼。
ReconfigStream	可讓對資料流程組態所做的變更包含在設定檔中。
RemoveMutualExclusion	從設定檔中移除互斥物件。
RemoveStream	從設定檔中移除資料流程。
RemoveStreamByNumber	從設定檔中移除資料流程。
SetDescription	指定設定檔的描述。
SetName	指定設定檔的名稱。

如需可以使用這個介面的 QueryInterface 方法取得哪些介面的相關資訊，請參閱實作這個介面的物件主題。

另請參閱

介面

IWMProfileManager 介面

設定檔管理員物件

讀取器物件

同步讀取器物件

使用設定檔