Méthode IWMPMedia3::getItemInfoByType

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La méthode getItemInfoByType retourne la valeur de l’attribut correspondant au type d’attribut et à l’index spécifiés.

Syntaxe

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

Paramètres

bstrType [in]

System.String qui est le type d’attribut.

bstrLanguage [in]

System.String qui est la langue. Si la valeur est définie sur null ou sur une chaîne de longueur nulle («  »), la chaîne de paramètres régionaux actuelle est utilisée. Sinon, la valeur doit être une chaîne de langue RFC 1766 valide telle que « en-us ».

lIndex [in]

System.Int32 qui est l’index d’attribut.

Valeur retournée

System.Object qui est la valeur de l’attribut. Le type de conversion de cet objet dépend du type de l’attribut.

Notes

Cette méthode retourne les métadonnées d’un élément multimédia numérique individuel ou d’un élément multimédia faisant partie d’une playlist.

Cette méthode prend en charge les attributs avec plusieurs valeurs et les attributs avec des valeurs complexes. La méthode getItemInfo ne prend pas en charge les attributs avec plusieurs valeurs et les attributs avec des valeurs complexes.

La propriété attributeCount obtient le nombre de noms d’attributs disponibles pour un élément multimédia donné. Les numéros d’index peuvent ensuite être utilisés avec la méthode getAttributeName pour déterminer le nom de chaque attribut disponible. Les noms d’attributs individuels peuvent être passés au paramètre name de getItemInfoByType.

La méthode getAttributeCountByType retourne le nombre d’attributs qui correspondent à un nom d’attribut particulier pour un élément multimédia donné. Les numéros d’index peuvent ensuite être passés au paramètre d’index de getItemInfoByType. Cela est utile lorsqu’un élément multimédia a été classé sous plusieurs genres, par exemple.

Si l’élément multimédia provient d’une bibliothèque qui a été récupérée en appelant IWMPLibrary.mediaCollection, l’ensemble des attributs disponibles diffère de ceux qui peuvent être interrogés à partir de la bibliothèque locale récupérée en appelant AxWindowsMediaPlayer.mediaCollection. Par exemple, les attributs disponibles à partir de la bibliothèque locale récupérée à l’aide d’IWMPLibrary seront un sous-ensemble des attributs disponibles à partir de la bibliothèque locale récupérée à l’aide d’AxWindowsMediaPlayer. L’ensemble d’attributs disponibles à partir d’autres sources (bibliothèques distantes, appareils portables ou CD) est défini par les autres sources.

Avant d’appeler cette méthode, vous devez disposer d’un accès en lecture à la bibliothèque. Pour plus d’informations, consultez Accès à la bibliothèque.

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows série 9 ou ultérieure
Espace de noms	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Voir aussi

Interface IWMPMedia3 (VB et C#)

IWMPMedia.attributeCount (VB et C#)

IWMPMedia.getAttributeName (VB et C#)

IWMPMedia.getItemInfo (VB et C#)

IWMPMedia3.getAttributeCountByType (VB et C#)