Método Media.getItemInfo

[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 getItemInfo recupera el valor del atributo especificado para el elemento multimedia actual.

Sintaxis

strRetVal = Media.getItemInfo(
  name
)

Parámetros

name [in]

Cadena que contiene el nombre del atributo. Para obtener información sobre los atributos admitidos por Reproductor multimedia de Windows, consulte la referencia de atributos de Reproductor multimedia de Windows.

Valor devuelto

Este método devuelve una cadena que representa el valor del atributo especificado. Para los atributos cuyo valor subyacente es Boolean, devuelve la cadena "true" o "false".

Observaciones

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

La propiedad attributeCount contiene el número de nombres de atributo disponibles para un objeto Media 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 a getItemInfo.

Para recuperar atributos con varios valores y atributos con valores complejos, use el método getItemInfoByType .

Para usar este método, se requiere acceso de lectura a la biblioteca. Para obtener más información, consulte Acceso a la biblioteca.

Para compartir las bibliotecas multimedia de Windows a través de UPnP, Reproductor multimedia de Windows crea un servicio de directorio de contenido (CDS) que se expone a través de UPnP. A continuación, otros dispositivos pueden navegar y examinar las bibliotecas.

En Windows 7, una aplicación puede usar los atributos Reproductor multimedia de Windows TrackingID y MediaType para construir el identificador de objeto de cada elemento del CDS. Tenga en cuenta que esta construcción podría cambiar en versiones futuras de Windows. La aplicación pasa cada una de estas cadenas de atributo en el parámetro name de una llamada a getItemInfo. getItemInfo devuelve el valor de cada atributo del valor devuelto. A continuación, la aplicación usa la sintaxis siguiente para construir cada identificador de objeto:

TrackingID.0. MediaTypeID

Esta sintaxis tiene el siguiente significado:

• TrackingID es la cadena que se almacena en el atributo TrackingID de Reproductor multimedia de Windows del elemento multimedia.

• MediaTypeID depende del valor del atributo MediaType , como se muestra en la tabla siguiente:

  Atributo MediaType	MediaTypeID
  Elementos de audio	4
  Elementos de fotos	B
  Elementos de vídeo	8

Reproductor multimedia de Windows 10 Mobile: los atributos de un elemento multimedia solo están disponibles durante la reproducción a menos que se recuperen del elemento a través de la colección multimedia.

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows versión 7.0 o posterior.
Archivo DLL	Wmp.dll

Consulte también

Media (objeto)

Media.attributeCount

Media.getAttributeName

Media.getItemInfoByType

Media.setItemInfo

Lectura de valores de atributo

Settings.mediaAccessRights

Settings.requestMediaAccessRights