IWMPMedia3：：getItemInfoByType 方法

  • 项目

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

getItemInfoByType 方法返回对应于指定属性类型和索引的属性的值。

语法

public System.Object getItemInfoByType(
  System.String bstrType,
  System.String bstrLanguage,
  System.Int32 lIndex
);


Public Function getItemInfoByType( _
  ByVal bstrType As System.String, _
  ByVal bstrLanguage As System.String, _
  ByVal lIndex As System.Int32 _
) As System.Object
Implements IWMPMedia3.getItemInfoByType

parameters

bstrType [in]

作为属性类型的 System.String 。

bstrLanguage [in]

作为语言的 System.String 。 如果该值设置为 null 或零长度字符串 (“”) ，则使用当前区域设置字符串。 否则，该值必须是有效的 RFC 1766 语言字符串，例如“en-us”。

lIndex [in]

作为属性索引的 System.Int32 。

返回值

一个 System.Object ，它是 特性的值。 要将此对象强制转换为的类型取决于 属性的类型。

备注

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

此方法支持具有多个值的属性和具有复杂值的属性。 getItemInfo 方法不支持具有多个值的属性和具有复杂值的属性。

attributeCount 属性获取可用于给定媒体项的属性名称的数目。 然后，索引号可以与 getAttributeName 方法一起使用，以确定每个可用属性的名称。 单个属性名称可以传递给 getItemInfoByType 的 name 参数。

getAttributeCountByType 方法返回对应于给定媒体项的特定属性名称的属性数。 然后，可以将索引号传递给 getItemInfoByType 的索引参数。 例如，当媒体项目被归类为多个流派时，这非常有用。

如果媒体项来自通过调用 IWMPLibrary.mediaCollection 检索的库，则可用属性集将不同于可通过调用 AxWindowsMediaPlayer.mediaCollection 从本地库中查询的属性集。 例如，使用 IWMPLibrary 检索的本地库中可用的属性将是使用 AxWindowsMediaPlayer 检索到的本地库中可用的属性的子集。 其他源 (远程库、便携式设备或 CD 提供的属性集由其他源定义。

在调用此方法之前，必须具有对库的读取访问权限。 有关详细信息，请参阅 库访问。

要求

要求 值
版本
 Windows 媒体播放器 9 系列或更高版本
命名空间
 WMPLib
程序集
Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

另请参阅

IWMPMedia3 接口 (VB 和 C#)

IWMPMedia.attributeCount (VB 和 C#)

IWMPMedia.getAttributeName (VB 和 C#)

IWMPMedia.getItemInfo (VB 和 C#)

IWMPMedia3.getAttributeCountByType (VB 和 C#)