Media.getItemInfo 方法

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

getItemInfo 方法检索当前媒体项的指定属性的值。

语法

strRetVal = Media.getItemInfo(
  name
)

参数

name [in]

包含属性名称的字符串。 有关 Windows 媒体播放器 支持的属性的信息，请参阅 Windows 媒体播放器 属性参考。

返回值

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

备注

此方法检索单个数字媒体项或属于播放列表的媒体项的元数据。

attributeCount 属性包含给定 Media 对象可用的属性名称数。 然后，索引号可以与 getAttributeName 方法一起使用，以确定每个可用属性的名称。 单个属性名称可以传递给 getItemInfo。

若要检索具有多个值的属性和具有复杂值的属性，请使用 getItemInfoByType 方法。

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

若要通过 UPnP 共享 Windows 媒体库，Windows 媒体播放器创建通过 UPnP 公开 (CDS) 的内容目录服务。 然后，其他设备可以导航和浏览库。

在 Windows 7 中，应用程序可以使用 Windows 媒体播放器 TrackingID 和 MediaType 属性来构造 CDS 中每个项的对象 ID。 请注意，此构造在 Windows 的未来版本中可能会更改。 应用程序在调用 getItemInfo 时，在 name 参数中传递其中每个属性字符串。 getItemInfo 返回返回值中每个属性的值。 然后，应用程序使用以下语法构造每个对象 ID：

TrackingID.0。MediaTypeID

此语法具有以下含义：

• TrackingID 是存储在媒体项的 Windows 媒体播放器 TrackingID 属性中的字符串。

• MediaTypeID 取决于 MediaType 属性的值，如下表所示：

  MediaType 属性	MediaTypeID
  音频项	4
  照片项目	B
  视频项	8

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

要求

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

另请参阅

Media 对象

Media.attributeCount

Media.getAttributeName

Media.getItemInfoByType

Media.setItemInfo

读取属性值

Settings.mediaAccessRights

Settings.requestMediaAccessRights