Metodo IWMPMedia3::getItemInfoByType

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo getItemInfoByType restituisce il valore dell'attributo corrispondente al tipo di attributo e all'indice specificati.

Sintassi

public System.Object getItemInfoByType(
  System.String bstrType,
  System.String bstrLanguage,
  System.Int32 lIndex
);

Public Function getItemInfoByType( _
  ByVal bstrType As System.String, _
  ByVal bstrLanguage As System.String, _
  ByVal lIndex As System.Int32 _
) As System.Object
Implements IWMPMedia3.getItemInfoByType

Parametri

bstrType [in]

Oggetto System.String che rappresenta il tipo di attributo.

bstrLanguage [in]

Oggetto System.String che rappresenta la lingua. Se il valore è impostato su Null o su una stringa di lunghezza zero (""), viene usata la stringa delle impostazioni locali corrente. In caso contrario, il valore deve essere una stringa di lingua RFC 1766 valida, ad esempio "en-us".

lIndex [in]

Oggetto System.Int32 che è l'indice dell'attributo.

Valore restituito

Oggetto System.Object che rappresenta il valore dell'attributo. Il tipo da cui eseguire il cast dell'oggetto dipende dal tipo dell'attributo.

Commenti

Questo metodo restituisce i metadati per un singolo elemento multimediale digitale o un elemento multimediale che fa parte di una playlist.

Questo metodo supporta attributi con più valori e attributi con valori complessi. Il metodo getItemInfo non supporta attributi con più valori e attributi con valori complessi.

La proprietà attributeCount ottiene il numero di nomi di attributi disponibili per un determinato elemento multimediale. I numeri di indice possono quindi essere usati con il metodo getAttributeName per determinare il nome di ogni attributo disponibile. I nomi dei singoli attributi possono essere passati al parametro name di getItemInfoByType.

Il metodo getAttributeCountByType restituisce il numero di attributi che corrispondono a un determinato nome di attributo per un determinato elemento multimediale. I numeri di indice possono quindi essere passati al parametro index di getItemInfoByType. Ciò è utile quando un elemento multimediale è stato categorizzato in più generi, ad esempio.

Se l'elemento multimediale proviene da una libreria recuperata chiamando IWMPLibrary.mediaCollection, il set di attributi disponibili sarà diverso da quelli che possono essere sottoposti a query dalla libreria locale recuperata chiamando AxWindowsMediaPlayer.mediaCollection. Ad esempio, gli attributi disponibili dalla libreria locale recuperati tramite IWMPLibrary saranno un subset degli attributi disponibili dalla libreria locale recuperata tramite AxWindowsMediaPlayer. Il set di attributi disponibili da altre origini (librerie remote, dispositivi portatili o CD è definito dalle altre origini.

Prima di chiamare questo metodo, è necessario disporre dell'accesso in lettura alla libreria. Per altre informazioni, vedere Accesso alla libreria.

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows serie 9 o successive
Spazio dei nomi	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Vedi anche

Interfaccia IWMPMedia3 (VB e C#)

IWMPMedia.attributeCount (VB e C#)

IWMPMedia.getAttributeName (VB e C#)

IWMPMedia.getItemInfo (VB e C#)

IWMPMedia3.getAttributeCountByType (VB e C#)