Media.getItemInfoByAtom-Methode

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

Die getItemInfoByAtom-Methode ruft den Wert des Attributs mit der angegebenen Indexnummer ab.

Syntax

strRetVal = Media.getItemInfoByAtom(
  index
)

Parameter

Index [in]

Zahl (long), die den Index angibt, an dem sich ein bestimmtes Attribut innerhalb der Gruppe der verfügbaren Attribute befindet.

Rückgabewert

Diese Methode gibt einen String-Wert zurück, der den Wert des angegebenen Attributs darstellt. Für Attribute, deren zugrunde liegender Wert boolesch ist, wird die Zeichenfolge "true" oder "false" zurückgegeben.

Bemerkungen

Diese Methode kann verwendet werden, um Metadaten für ein bestimmtes digitales Medienelement mithilfe einer Attributindexnummer abzurufen. Die attributeCount-Eigenschaft kann verwendet werden, um die Anzahl der für das Medienelement verfügbaren Attribute zu bestimmen.

Die getMediaAtom-Methode des MediaCollection-Objekts kann auch verwendet werden, um den Index eines bestimmten Attributs abzurufen. Diese Technik ist bei der Arbeit mit großen Wiedergabelisten im Allgemeinen effizienter als die GetItemInfo- oder getItemInfoByType-Methoden.

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

Informationen zu den von Windows Medienwiedergabe unterstützten Attributen finden Sie in der 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 über die Mediensammlung aus dem Element abgerufen.

Anforderungen

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

Siehe auch

Media-Objekt

Media.attributeCount

Media.getItemInfo

Media.getItemInfoByType

Media.setItemInfo

MediaCollection.getMediaAtom

Lesen von Attributwerten

Settings.mediaAccessRights

Settings.requestMediaAccessRights