使用中繼資料
[與此頁面相關聯的功能 Windows Media Format 11 SDK是舊版功能。 來源讀取器和接收寫入器已取代它。 來源讀取器和接收寫入器已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用來源讀取器和接收寫入器，而不是Windows Media Format 11 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]
中繼資料支援是由寫入器物件、讀取器和同步讀取器物件，以及中繼資料編輯器物件所提供。 如需中繼資料的一般資訊，請參閱 中繼資料。 如需 Windows 媒體格式 SDK 中支援中繼資料的功能相關資訊，請參閱 中繼資料功能。
中繼資料編輯的介面是 IWMHeaderInfo3，您可以藉由呼叫上述其中一個物件中的任何介面 的 QueryInterface 方法來取得。 IWMHeaderInfo3 繼承 IWMHeaderInfo 和 IWMHeaderInfo2的方法。 處理中繼資料屬性的 IWMHeaderInfo3 方法，代表存取中繼資料的方法，與 IWMHeaderInfo方法所使用的方法不同。 您應該一律使用較新的方法。
ASF 檔案中的中繼資料是由索引和資料流程編號所識別。 檔案層級屬性會指派資料流程編號 0。 在舊版的 Windows 媒體格式 SDK 中，屬性可以依名稱來識別。 不過，因為您現在可以在資料流程中複製屬性名稱，所以無法再使用這個名稱。 相反地，您可以擷取符合名稱的所有索引。 如需詳細資訊，請參閱 擷取中繼資料屬性。
為了協助快速尋找屬性，您可以使用特殊的資料流程編號，0xFFFF。 使用此資料流程編號來識別整個檔案，而不是特定資料流程或檔案層級屬性。 Windows Media Format SDK 的物件會針對每個資料流程和檔案層級屬性維護個別的索引。 使用資料流程0xFFFF時，索引與指定特定資料流程時所使用的索引不同。 例如，為數據流 0 索引 0 的屬性與資料流程索引 0 的屬性不相同0xFFFF。
下列各節將更詳細地描述中繼資料的使用方式。
| 區段 | 描述 |
|---|---|
| 擷取中繼資料屬性 | 描述如何從檔案標頭讀取中繼資料屬性。 |
| 設定中繼資料屬性 | 描述如何將新的中繼資料屬性新增至檔案標頭。 |
| 編輯中繼資料屬性 | 描述如何編輯現有的中繼資料屬性。 |
| 移除中繼資料屬性 | 描述如何移除現有的中繼資料屬性。 |
| 使用複雜中繼資料屬性 | 描述如何使用結構表示其值的屬性。 |
其中幾個範例應用程式示範如何擷取和編輯中繼資料。 特別是，請參閱 MetadataEdit 範例，這同時隨附于 C++ 和 C# 版本。
相關主題