Media.getItemInfo-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 getItemInfo-Methode ruft den Wert des angegebenen Attributs für das aktuelle Medienelement ab.

Syntax

strRetVal = Media.getItemInfo(
  name
)

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.

Rückgabewert

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

Bemerkungen

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

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 getItemInfo übergeben werden.

Zum Abrufen von Attributen mit mehreren Werten und Attributen mit komplexen Werten verwenden Sie die getItemInfoByType-Methode .

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

Um die Windows-Medienbibliotheken über UPnP freizugeben, erstellt Windows Medienwiedergabe einen Inhaltsverzeichnisdienst (CDS), der über UPnP verfügbar gemacht wird. Andere Geräte können dann in den Bibliotheken navigieren und sie durchsuchen.

In Windows 7 kann eine Anwendung die Attribute Windows Medienwiedergabe TrackingID und MediaType verwenden, um die Objekt-ID jedes Elements im CDS zu erstellen. Beachten Sie, dass sich diese Konstruktion in zukünftigen Versionen von Windows ändern kann. Die Anwendung übergibt jede dieser Attributzeichenfolgen im parameter name in einem Aufruf von getItemInfo. getItemInfo gibt den Wert für jedes Attribut im Rückgabewert zurück. Die Anwendung verwendet dann die folgende Syntax, um jede Objekt-ID zu erstellen:

TrackingID.0. MediaTypeID

Diese Syntax hat die folgende Bedeutung:

• TrackingID ist die Zeichenfolge, die im Windows Medienwiedergabe TrackingID-Attribut des Medienelements gespeichert ist.

• MediaTypeID hängt vom Wert des MediaType-Attributs ab, wie in der folgenden Tabelle gezeigt:

  MediaType-Attribut	MediaTypeID
  Audioelemente	4
  Fotoelemente	B
  Videoelemente	8

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.

Anforderungen

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

Siehe auch

Medienobjekt

Media.attributeCount

Media.getAttributeName

Media.getItemInfoByType

Media.setItemInfo

Lesen von Attributwerten

Settings.mediaAccessRights

Settings.requestMediaAccessRights