Profile 物件
[與此頁面相關聯的功能 Windows Media Format 11 SDK是舊版功能。 來源讀取器和接收寫入器已取代它。 來源讀取器和接收寫入器已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用來源讀取器和接收寫入器,而不是Windows 媒體格式 11 SDK。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。
設定檔物件會管理設定檔的設定。 您可以為現有的設定檔資料建立設定檔物件,也可以建立空的,以便接收新的資料。 當載入檔案以供讀取時,讀取器物件也會建立設定檔物件 (和同步讀取器物件) 。 在此情況下,物件會填入儲存在檔案標頭中的設定檔資訊。
若要儲存設定檔物件的內容,您必須呼叫 IWMProfileManager::SaveProfile。
設定檔包含多個物件,可控制設定檔 (的各種層面,例如資料流程) 。 所有這些物件都是從屬至設定檔物件。 您不會使用建立函式來建立這些物件,如同此 SDK 的主要物件一樣。 相反地,設定檔物件的介面會包含建立次級物件的方法。
若要建立設定檔物件,請呼叫下列其中一種方法。
方法 | 描述 |
---|---|
IWMProfileManager::CreateEmptyProfile | 建立不含任何設定檔資料的設定檔物件。 |
IWMProfileManager::LoadProfileByData | 建立設定檔物件,其中包含儲存為字串之設定檔的資料。 這是使用自訂設定檔資料建立設定檔物件的唯一方式。 |
IWMProfileManager::LoadProfileByID | 建立填入系統設定檔資料的設定檔物件。 使用 GUID 來識別所需的系統設定檔。 |
IWMProfileManager::LoadSystemProfile | 建立填入系統設定檔資料的設定檔物件。 使用設定檔索引來識別所需的系統設定檔。 |
上表中的所有方法都會設定 IWMProfile 介面的指標。 呼叫 QueryInterface 方法,即可取得設定檔物件的其他介面。
每個設定檔物件都支援下列介面。
介面 | 描述 |
---|---|
IWMLanguageList | 管理 ASF 檔案支援的語言清單。 |
IWMPacketSize | 控制檔案中封包的大小上限。 |
IWMPacketSize2 | 控制檔案中封包的大小下限。 繼承 IWMPacketSize的所有方法。 |
IWMProfile | 控制設定檔中包含的基本設定和物件。 |
IWMProfile2 | 擷取與設定檔相關聯的全域唯一識別碼 (GUID) 。 繼承 IWMProfile的所有方法。 |
IWMProfile3 | 控制設定檔中的頻寬共用和串流優先順序資訊。 繼承 IWMProfile 和 IWMProfile2的所有方法。 |
相關主題