Media.getItemInfoByType-Methode

[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 getItemInfoByType-Methode ruft den Wert des Attributs ab, das dem angegebenen Attributnamen, der angegebenen Sprache und dem angegebenen Index entspricht.

Syntax

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

Parameter

Name [in]

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

Sprache [in]

Zeichenfolge , die die Sprache darstellt. Wenn der Wert auf NULL oder "" (leere Zeichenfolge) festgelegt ist, wird die aktuelle Gebietsschemazeichenfolge verwendet. Andernfalls muss der Wert eine gültige RFC 1766-Sprachzeichenfolge wie "en-us" sein.

Index [in]

Zahl (long) mit dem nullbasierten Index des Werts, der aus dem Attribut abgerufen werden soll.

Rückgabewert

Diese Methode gibt ein Number-, String-, MetadataPicture- oder MetadataText-Objekt zurück, wie in der folgenden Tabelle angegeben.

attribute	Rückgabewert
SyncState	Zahl (ohne Vorzeichen lang)
WM/Lyrics_Synchronised	MetadataText-Objekt
WM/Bild	MetadataPicture-Objekt
WM/UserWebURL	MetadataText-Objekt
Alle anderen Attribute	String

Für Attribute, deren zugrunde liegender Wert boolean ist, gibt diese Methode die Zeichenfolge "true" oder "false" zurück.

Bemerkungen

Diese Methode ruft die Metadaten für ein einzelnes digitales Medienelement oder ein Medienelement ab, das Teil einer Wiedergabeliste ist.

Diese Methode unterstützt Attribute mit mehreren Werten und Attribute mit komplexen Werten. Die getItemInfo-Methode unterstützt keine Attribute mit mehreren Werten und Attribute mit komplexen Werten.

Die attributCount-Eigenschaft enthält die Anzahl der Attributnamen, die für ein bestimmtes Media-Objekt verfügbar sind. Indexnummern können dann mit der getAttributeName-Methode verwendet werden, um den Namen jedes verfügbaren Attributs zu bestimmen. Einzelne Attributnamen können an den namensparameter von getItemInfoByType übergeben werden.

Die getAttributeCountByType-Methode gibt die Anzahl der Attribute zurück, die einem bestimmten Attributnamen für ein bestimmtes Media-Objekt entsprechen. Indexnummern können dann an den Indexparameter von getItemInfoByType übergeben werden. Dies ist nützlich, wenn ein digitales Medienelement z. B. unter mehrere Genres kategorisiert wurde.

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

Diese Methode kann Fehler verursachen. Sie sollten Fehlerbehandlungscode einschließen, wenn Sie diese Methode aufrufen. Beispielsweise können Sie in JScript die Fehlerbehandlung implementieren, indem Sie die try... Fangen... schließlich Struktur.

Windows Medienwiedergabe 10 Mobile: Diese Methode wird nicht unterstützt.

Anforderungen

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

Siehe auch

Medienobjekt

Media.attributeCount

Media.getAttributeCountByType

Media.getAttributeName

Media.getItemInfo

Media.setItemInfo

MetadataPicture-Objekt

MetadataText-Objekt

Lesen von Attributwerten

Settings.mediaAccessRights

Settings.requestMediaAccessRights