Media.getAttributeName-Methode

  • Artikel

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die getAttributeName-Methode ruft den Namen des Attributs ab, das dem angegebenen Index entspricht.

Syntax

strRetVal = Media.getAttributeName(
  index
)

Parameter

Index [in]

Zahl (lang), die den Index des Attributs enthält.

Rückgabewert

Diese Methode gibt einen String-Wert zurück, der den Namen des Attributs angibt.

Bemerkungen

Der zurückgegebene Attributname kann in Verbindung mit getItemInfo verwendet werden, um den Wert für ein bestimmtes benanntes Attribut abzurufen.

Um diese Methode zu verwenden, ist Lesezugriff auf die Bibliothek erforderlich. Weitere Informationen finden Sie unter Bibliothekszugriff.

Informationen zu den von Windows Medienwiedergabe unterstützten Attributen finden Sie unter Windows Medienwiedergabe Attributreferenz..

Windows Medienwiedergabe 10 Mobile: Attribute für ein Medienelement sind nur während der Wiedergabe verfügbar, es sei denn, sie werden aus dem Element über die Mediensammlung abgerufen.

Beispiele

Im folgenden JScript-Beispiel wird Media verwendet. getAttributeName , um einen HTML-Textbereich namens myText mit dem Index und namen jedes Attributs für das aktuelle Medienelement zu füllen. Das Player-Objekt wurde mit der ID = "Player" erstellt.

// Store the current media object.
var cm = Player.currentMedia;

// Get the number of attributes for the current media. 
var atCount = cm.attributeCount;

// Loop through the attribute list.
for(var i=0; i < atCount; i++){
   
   // Print each attribute index and name.   
   myText.value += "Attribute " + i +": ";
   myText.value += cm.getAttributeName(i);
   myText.value += "\n";
}

Anforderungen

Anforderung Wert
Version
 Windows Medienwiedergabe Version 7.0 oder höher.
DLL
Wmp.dll

Siehe auch

Medienobjekt

Media.attributeCount

Media.getItemInfo

Settings.mediaAccessRights

Settings.requestMediaAccessRights