Media.getItemInfoByAtom 方法

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

getItemInfoByAtom 方法检索具有指定索引号的属性的值。

语法

strRetVal = Media.getItemInfoByAtom(
  index
)

parameters

index [in]

number (long) 指定给定属性驻留在可用属性集中的索引。

返回值

此方法返回一个 字符串 ，表示指定属性的值。 对于基础值为 Boolean 的属性，它将返回字符串“true”或“false”。

备注

此方法可用于使用属性索引号检索特定数字媒体项的元数据。 attributeCount 属性可用于确定媒体项可用的属性数。

MediaCollection 对象的 getMediaAtom 方法也可用于检索特定属性的索引。 使用大型播放列表时，此方法通常比 getItemInfo 或 getItemInfoByType 方法更高效。

若要使用此方法，需要对库的读取访问权限。 有关详细信息，请参阅 库访问。

有关 Windows 媒体播放器 支持的属性的信息，请参阅 Windows 媒体播放器 特性参考。

Windows 媒体播放器 10 移动：媒体项的属性仅在播放期间可用，除非通过媒体集合从项中检索它们。

要求

要求	值
版本	Windows 媒体播放器版本 7.0 或更高版本。
DLL	Wmp.dll

另请参阅

Media 对象

Media.attributeCount

Media.getItemInfo

Media.getItemInfoByType

Media.setItemInfo

MediaCollection.getMediaAtom

读取属性值

Settings.mediaAccessRights

Settings.requestMediaAccessRights