MediaCollection.getPlaylistByQuery 方法
[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 MediaPlayer已取代它。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer,而不是Windows 媒體播放機 SDK。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。
getPlaylistByQuery方法會擷取包含符合查詢準則之Media物件的Playlist物件。
語法
retVal = MediaCollection.getPlaylistByQuery(
query,
mediaType,
sortAttribute,
sortAscending
)
參數
-
查詢 [in]
-
查詢 物件,定義用來建立播放清單的條件。
-
mediaType [in]
-
包含媒體類型的字串。 必須包含下列其中一個值:「audio」、「video」、「photo」、「playlist」 或 「other」。
-
sortAttribute [in]
-
字串 ,其中包含用於排序的屬性名稱。 空字串 (「」「) 表示不會套用排序。
-
sortAscending [in]
-
布林值,true 表示播放清單必須以遞增順序排序。
傳回值
這個方法會傳回 Playlist 物件。
備註
使用 Query 的複合查詢不區分大小寫。
當 查詢 參數指定的複合查詢包含以 MediaType 屬性為基礎的條件時,則會忽略該條件。 一律會使用 mediaType 參數的值。 例如,如果複合查詢包含條件 「MediaType Equals audio」,且 mediaType 參數的值是 「video」,則產生的播放清單只會包含視訊專案。
規格需求
需求 | 值 |
---|---|
版本 |
Windows 媒體播放機 11。 |
DLL |
|
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應