MediaCollection.getMediaAtom-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 getMediaAtom-Methode ruft den Index ab, an dem sich ein angegebenes Attribut innerhalb der Gruppe der verfügbaren Attribute befindet.

Syntax

retVal = MediaCollection.getMediaAtom(
  attribute
)

Parameter

Attribut [in]

Zeichenfolge , die den Attributnamen enthält. Informationen zu den von Windows Medienwiedergabe unterstützten Attributen finden Sie in der Windows Medienwiedergabe-Attributreferenz.

Rückgabewert

Diese Methode gibt einen Wert vom Typ Number (long) zurück.

Bemerkungen

Die mit dieser Methode abgerufene Indexnummer kann an die Medien übergeben werden. getItemInfoByAtom-Methode für den Zugriff auf Attributwerte. Diese Technik ist bei der Arbeit mit großen Wiedergabelisten im Allgemeinen effizienter als der Zugriff auf einen Attributwert anhand des Namens über Media. getItemInfo oder Media. getItemInfoByType.

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

Anforderungen

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

Siehe auch

Media.getItemInfo

Media.getItemInfoByAtom

Media.getItemInfoByType

MediaCollection-Objekt

Settings.mediaAccessRights

Settings.requestMediaAccessRights