Media.getItemInfoByType 方法

  • 發行項

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 MediaPlayer已取代它。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

getItemInfoByType方法會擷取對應至指定屬性名稱、語言和索引的屬性值。

語法

retVal = Media.getItemInfoByType(
  name,
  language,
  index
)

參數

name [in]

包含 屬性名稱的字串。 如需Windows 媒體播放機所支援屬性的相關資訊，請參閱Windows 媒體播放機屬性參考。

語言 [in]

代表 語言的字串。 如果此值設定為 null 或 「」 (空字串) 會使用目前的地區設定字串。 否則，此值必須是有效的 RFC 1766 語言字串，例如 「en-us」。

index [in]

number (long) 包含要從 屬性擷取之值之以零起始的索引。

傳回值

這個方法會傳回 Number、 String、 MetadataPicture 物件或 MetadataText 物件，如下表所示。

屬性 傳回值
SyncState 不帶正負號長) 的數位 (
WM/Lyrics_Synchronised MetadataText 物件
WM/Picture MetadataPicture 物件
WM/UserWebURL MetadataText 物件
所有其他屬性 String

對於基礎值為 布林值的屬性，這個方法會傳回字串 「true」 或 「false」。

備註

這個方法會擷取個別數位媒體專案的中繼資料，或屬於播放清單一部分的媒體專案。

這個方法支援具有多個值的屬性，以及具有複雜值的屬性。 getItemInfo方法不支援具有多個值的屬性，以及具有複雜值的屬性。

attributeCount屬性包含指定Media物件可用的屬性名稱數目。 然後，索引編號可以搭配 getAttributeName 方法使用，以判斷每個可用屬性的名稱。 個別屬性名稱可以傳遞至getItemInfoByType的名稱參數。

getAttributeCountByType方法會傳回對應至指定Media物件之特定屬性名稱的屬性數目。 然後，索引編號可以傳遞至getItemInfoByType的索引參數。 例如，當數位媒體專案分類為多個內容類型時，這非常有用。

若要使用此方法，需要程式庫的讀取權限。 如需詳細資訊，請參閱 程式庫存取。

這個方法可能會造成錯誤。 當您呼叫此方法時，應該包含錯誤處理常式代碼。 例如，在 JScript 中，您可以使用 try 來實作錯誤處理 ...抓住。。。finally 結構。

Windows 媒體播放機 10 行動裝置版：不支援此方法。

規格需求

需求 值
版本
 Windows Media Player  9  系列或更新的版本。
DLL
Wmp.dll

另請參閱

Media 物件

Media.attributeCount

Media.getAttributeCountByType

Media.getAttributeName

Media.getItemInfo

Media.setItemInfo

MetadataPicture 物件

MetadataText 物件

讀取屬性值

Settings.mediaAccessRights

Settings.requestMediaAccessRights