Metodo Media.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 recupera il valore dell'attributo corrispondente al nome, alla lingua e all'indice dell'attributo specificati.

Sintassi

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

Parametri

name [in]

Stringa contenente il nome dell'attributo. Per informazioni sugli attributi supportati da Lettore multimediale Windows, vedere riferimento all'attributo Lettore multimediale Windows.

lingua [in]

Stringa che rappresenta la lingua. Se il valore è impostato su null o "" (stringa vuota) 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".

index [in]

Numero (long) contenente l'indice in base zero del valore da recuperare dall'attributo .

Valore restituito

Questo metodo restituisce un oggetto Number, String, MetadataPicture o MetadataText , come indicato nella tabella seguente.

Attributo	Valore restituito
SyncState	Numero (long senza segno)
WM/Lyrics_Synchronised	Oggetto MetadataText
WM/Immagine	Oggetto MetadataPicture
WM/UserWebURL	Oggetto MetadataText
Tutti gli altri attributi	Stringa

Per gli attributi il cui valore sottostante è Boolean, questo metodo restituisce la stringa "true" o "false".

Commenti

Questo metodo recupera 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 contiene il numero di nomi di attributi disponibili per un determinato oggetto Media . 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 oggetto Media . I numeri di indice possono quindi essere passati al parametro index di getItemInfoByType. Ciò è utile quando un elemento multimediale digitale è stato classificato in più generi, ad esempio.

Per usare questo metodo, è necessario l'accesso in lettura alla libreria. Per altre informazioni, vedere Accesso alla libreria.

Questo metodo può causare errori. È consigliabile includere il codice di gestione degli errori quando si chiama questo metodo. In JScript, ad esempio, è possibile implementare la gestione degli errori usando try... Prendere... struttura finally .

Lettore multimediale Windows 10 Mobile: questo metodo non è supportato.

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows serie 9 o successive.
DLL	Wmp.dll

Vedi anche

Oggetto Media

Media.attributeCount

Media.getAttributeCountByType

Media.getAttributeName

Media.getItemInfo

Media.setItemInfo

Oggetto MetadataPicture

Oggetto MetadataText

Lettura dei valori degli attributi

Settings.mediaAccessRights

Settings.requestMediaAccessRights