MediaCollection.getMediaAtom 方法
[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 它已被 MediaPlayer 取代。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer,而不是Windows 媒體播放機 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼,以使用新的 API。]
getMediaAtom方法會擷取指定屬性位於可用屬性集合內的索引。
語法
retVal = MediaCollection.getMediaAtom(
attribute
)
參數
-
屬性 [in]
-
包含屬性名稱的字串。 如需Windows 媒體播放機所支援屬性的相關資訊,請參閱Windows 媒體播放機屬性參考。
傳回值
此方法會傳回 Number (long) 。
備註
使用此方法擷取的索引編號可以傳遞至 媒體。getItemInfoByAtom 方法來存取屬性值。 使用大型播放清單時,這項技術通常比透過 媒體依名稱存取屬性值更有效率。getItemInfo 或 Media。getItemInfoByType。
若要使用此方法,需要程式庫的讀取權限。 如需詳細資訊,請參閱 程式庫存取。
規格需求
需求 | 值 |
---|---|
版本 |
Windows 媒體播放機 7.0 版或更新版本。 |
DLL |
|
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應