Método IWMPMedia3::getItemInfoByType

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El método getItemInfoByType devuelve el valor del atributo correspondiente al tipo de atributo y al índice especificados.

Sintaxis

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

Parámetros

bstrType [in]

System.String que es el tipo de atributo.

bstrLanguage [in]

System.String que es el idioma. Si el valor se establece en null o en una cadena de longitud cero (""), se usa la cadena de configuración regional actual. De lo contrario, el valor debe ser una cadena de idioma RFC 1766 válida, como "en-us".

lIndex [in]

System.Int32 que es el índice de atributo.

Valor devuelto

System.Object que es el valor del atributo . El tipo al que se va a convertir este objeto depende del tipo del atributo.

Observaciones

Este método devuelve los metadatos de un elemento multimedia digital individual o un elemento multimedia que forma parte de una lista de reproducción.

Este método admite atributos con varios valores y atributos con valores complejos. El método getItemInfo no admite atributos con varios valores y atributos con valores complejos.

La propiedad attributeCount obtiene el número de nombres de atributo disponibles para un elemento multimedia determinado. A continuación, los números de índice se pueden usar con el método getAttributeName para determinar el nombre de cada atributo disponible. Los nombres de atributo individuales se pueden pasar al parámetro name de getItemInfoByType.

El método getAttributeCountByType devuelve el número de atributos que corresponden a un nombre de atributo determinado para un elemento multimedia determinado. A continuación, los números de índice se pueden pasar al parámetro de índice de getItemInfoByType. Esto resulta útil cuando un elemento multimedia se ha categorizado en varios géneros, por ejemplo.

Si el elemento multimedia procede de una biblioteca que se recuperó mediante una llamada a IWMPLibrary.mediaCollection, el conjunto de atributos disponibles diferirá de los que se pueden consultar de la biblioteca local recuperada llamando a AxWindowsMediaPlayer.mediaCollection. Por ejemplo, los atributos disponibles en la biblioteca local recuperados mediante IWMPLibrary serán un subconjunto de los atributos disponibles en la biblioteca local recuperada mediante AxWindowsMediaPlayer. El conjunto de atributos disponibles desde otros orígenes (las bibliotecas remotas, los dispositivos portátiles o los DISCOS CD se definen mediante los demás orígenes.

Antes de llamar a este método, debe tener acceso de lectura a la biblioteca. Para obtener más información, consulte Acceso a la biblioteca.

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows serie 9 o posterior
Espacio de nombres	WMPLib
Ensamblado	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Consulte también

Interfaz IWMPMedia3 (VB y C#)

IWMPMedia.attributeCount (VB y C#)

IWMPMedia.getAttributeName (VB y C#)

IWMPMedia.getItemInfo (VB y C#)

IWMPMedia3.getAttributeCountByType (VB y C#)