Media.getItemInfo-Methode

Die getItemInfo-Methode ruft den Wert des angegebenen Attributs für das aktuelle Medienelement ab.

Syntax

strRetVal = Media.getItemInfo(
  name
)

Parameter

Name [ In]

Eine Zeichenfolge, die den Namen des Attributs enthält. Informationen zu den attributes, die von Windows Media Player unterstützt werden, finden Sie in der Windows Media Player Attribute Reference.

Rückgabewert

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

Hinweise

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

Die attributeCount-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.

Verwenden Sie zum Abrufen von Attributen mit mehreren Werten und Attributen mit komplexen Werten die getItemInfoByType-Methode.

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

Zum Freigeben Windows Medienbibliotheken über UPnP erstellt Windows Media Player einen Inhaltsverzeichnisdienst (CDS), der über UPnP verfügbar gemacht wird. Andere Geräte können dann in den Bibliotheken navigieren und diese durchsuchen.

In Windows 7 kann eine Anwendung die Attribute Windows Media Player TrackingID und MediaType verwenden, um die Objekt-ID der einzelnen Elemente im CDS zu erstellen. Beachten Sie, dass sich diese Konstruktion in zukünftigen Versionen von Windows. Die Anwendung übergibt jede dieser Attributzeichenfolgen im Namensparameter 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:

Windows Media Player 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 Media Player Version 7.0 oder höher.
DLL
Wmp.dll

Weitere Informationen

Medienobjekt

Media.attributeCount

Media.getAttributeName

Media.getItemInfoByType

Media.setItemInfo

Lesen von Attributwerten

Einstellungen.mediaAccessRights

Einstellungen.requestMediaAccessRights