Media.getAttributeCountByType 方法

  • 發行項

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

getAttributeCountByType方法會擷取與指定屬性名稱和語言相關聯的屬性數目。

語法

retVal = Media.getAttributeCountByType(
  name,
  language
)

參數

name [in]

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

語言 [in]

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

傳回值

這個方法會傳回 包含 屬性計數的 Number (long) 。

備註

這個方法可用來判斷對應至指定 Media 物件之特定屬性名稱的屬性數目。 接著可以將索引編號傳遞至 getItemInfoByType 方法。 例如，當媒體專案分類為多個內容類型時，這非常有用。

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

Windows 媒體播放機 10 行動裝置版：此屬性一律會傳回 0。

規格需求

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

另請參閱

MediaObject

Media.getItemInfoByType

Settings.mediaAccessRights

Settings.requestMediaAccessRights