物件 (Windows Media Format 11 SDK)

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

Windows 媒體格式 SDK 會使用數個物件來讀取、寫入、編輯和索引 ASF 檔案,以及建立和編輯設定檔。 每個物件都支援數個介面。 多個 物件支援某些介面。 在這些情況下,介面的參考一節會討論實作的任何差異。

Windows 媒體格式 SDK 中的物件符合 COM 規範。 為了方便開發,每個物件都有相關聯的建立函式或方法。 您應該使用建立函式或方法建立物件,而不是手動使用 COM 函式 CoCreateInstance

有些介面會附加至其名稱的數位,例如 IWMProfile2IWMWriter3。 在每個案例中,編號的版本都會繼承舊版的所有方法,並新增新功能。

在此參考的每個物件頁面上,主要 COM 物件中包含的介面會先列出,後面接著應用程式必須實作的回呼介面。

下表列出此 SDK 所支援的物件,其中包含每個 和用來建立它之函式的功能描述。

Object 描述 建立函式
備份還原器 備份授權,通常是卸載式媒體,然後將這些授權還原到不同的電腦上。 WMCreateBackupRestorer
裝置註冊 管理裝置註冊資料庫,其中包含可透過網路連線取得之媒體播放裝置的專案。 WMCreateDeviceRegistration
DRM Transcryptor 將受 DRM 保護的媒體資料轉換成資料流程,以傳送至使用 Windows Media DRM 10 for Network Devices 通訊協定的裝置。 WMCreateDRMTranscryptor
索引編製程式 建立 ASF 檔案的索引,以在具有視訊資料流程的檔案中搜尋。 WMCreateIndexer
授權撤銷代理程式 管理授權撤銷。 WMCreateLicenseRevocationAgent
中繼資料編輯器 編輯 ASF 檔案標頭中的中繼資料。 WMCreateEditor
設定檔管理員 提供介面來建立、載入及儲存設定檔。 需要設定檔才能寫入 ASF 檔案。 WMCreateProfileManager
讀取者 讀取 ASF 檔案。 這個物件會針對其作業使用非同步呼叫模型。 WMCreateReader
同步讀取器 使用同步呼叫讀取 ASF 檔案。 WMCreateSyncReader
作家 寫入 ASF 檔案。 WMCreateWriter
寫入器檔案接收 控制寫入器物件所寫入的 ASF 檔案。 WMCreateWriterFileSink
寫入器網路接收 控制寫入器物件所寫入 ASF 檔案的即時網路串流。 WMCreateWriterNetworkSink
寫入器推播接收 控制將串流內容傳遞至發佈伺服器。 WMCreateWriterPushSink

下表列出相依于其他物件的物件。 這些物件是由現有 物件的方法所建立。

Object 描述 建立方法
頻寬共用 管理設定檔中的頻寬共用資訊。 設定檔可能有多個頻寬共用物件。 根據您是否要建立新的頻寬共用物件或存取現有的共用物件,建立頻寬共用物件有不同的方法。 IWMProfile3::CreateNewBandwidthSharing
IWMProfile3::GetBandwidthSharing
Buffer 包含媒體範例和任何相關聯的資料單位延伸模組。 用於寫入和讀取範例。 IWMWriter::AllocateSample
IWMReaderAllocatorEx::AllocateForOutputEx
OR
IWMReaderAllocatorEx::AllocateForStreamEx
OR
由讀取器物件或同步讀取器物件自動建立以供範例傳遞。
輸入媒體屬性 管理輸入的屬性。 每個輸入都可以有一個輸入屬性物件。 IWMWriter::GetInputProps
互斥 管理設定檔中的相互排除資訊。 互斥的常見用法是數種語言的多個位元速率內容和音軌。 根據您是否要建立新的相互排除物件或存取現有的排除物件,有不同的方法可以建立相互排除物件。 IWMProfile::CreateNewMutualExclusion
IWMProfile::GetMutualExclusion
輸出媒體屬性 管理輸出的屬性。 每個輸出可以有一個輸出媒體屬性物件存在。 這些物件可由讀取器或同步讀取器建立 IWMReader::GetOutputProps
IWMSyncReader::GetOutputProps
設定檔 在設定檔中運算元據時,會包含該資料。 每當需要操作設定檔時,都會建立設定檔物件。 根據您是否要建立新的設定檔或存取現有的設定檔,建立設定檔物件有不同的方法。 IWMProfileManager::CreateEmptyProfile
IWMProfileManager::LoadProfileByData
OR
IWMProfileManager::LoadProfileByID
OR
IWMProfileManager::LoadSystemProfile
串流設定 管理設定檔中資料流程的屬性。 每當您需要存取資料流程相關資訊時,串流組態物件就會由資料流程物件建立。 根據您是否要建立新的資料流程或存取和現有資料流程,建立資料流程組態物件有不同的方法。 IWMProfile::CreateNewStream
IWMProfile::GetStream
OR
IWMProfile::GetStreamByNumber
資料流程優先順序 維護設定檔的資料流程優先順序清單。 如果可用的頻寬受到限制,資料流程將會依遞增優先順序來卸載。 設定檔中只能有一個資料流程優先順序物件。 IWMProfile3::CreateNewStreamPrioritization

程式設計參考