Méthode Media.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 récupère la valeur de l’attribut correspondant au nom d’attribut, à la langue et à l’index spécifiés.

Syntaxe

retVal = Media.getItemInfoByType(
  name,
  language,
  index
)

Paramètres

name [in]

Chaîne contenant le nom de l’attribut. Pour plus d’informations sur les attributs pris en charge par Lecteur multimédia Windows, consultez la référence d’attribut Lecteur multimédia Windows.

language [in]

Chaîne représentant la langue. Si la valeur est définie sur null ou « » (chaîne vide), 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 ».

index [in]

Nombre (long) contenant l’index de base zéro de la valeur à récupérer à partir de l’attribut.

Valeur retournée

Cette méthode retourne un objet Number, String, MetadataPicture ou MetadataText , comme indiqué dans le tableau suivant.

Attribut	Valeur retournée
SyncState	Nombre (long non signé)
WM/Lyrics_Synchronised	MetadataText, objet
WM/Image	Objet MetadataPicture
WM/UserWebURL	MetadataText, objet
Tous les autres attributs	Chaîne

Pour les attributs dont la valeur sous-jacente est Boolean, cette méthode retourne la chaîne « true » ou « false ».

Notes

Cette méthode récupère 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 contient le nombre de noms d’attributs disponibles pour un objet Media 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 objet Media 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 numérique a été classé sous plusieurs genres, par exemple.

Pour utiliser cette méthode, un accès en lecture à la bibliothèque est requis. Pour plus d’informations, consultez Accès à la bibliothèque.

Cette méthode peut provoquer des erreurs. Vous devez inclure du code de gestion des erreurs lorsque vous appelez cette méthode. Par exemple, dans JScript, vous pouvez implémenter la gestion des erreurs à l’aide de la commande try... catch... enfin structure.

Lecteur multimédia Windows 10 Mobile : cette méthode n’est pas prise en charge.

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows série 9 ou ultérieure.
DLL	Wmp.dll

Voir aussi

Objet Media

Media.attributeCount

Media.getAttributeCountByType

Media.getAttributeName

Media.getItemInfo

Media.setItemInfo

MetadataPicture, objet

MetadataText, objet

Lecture des valeurs d’attribut

Settings.mediaAccessRights

Settings.requestMediaAccessRights