Método Media.getItemInfoByAtom

[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 getItemInfoByAtom recupera el valor del atributo con el número de índice especificado.

Sintaxis

strRetVal = Media.getItemInfoByAtom(
  index
)

Parámetros

index [in]

Número (long) que especifica el índice en el que reside un atributo determinado dentro del conjunto de atributos disponibles.

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 se puede usar para recuperar metadatos de un elemento multimedia digital específico mediante un número de índice de atributo. La propiedad attributeCount se puede usar para determinar el número de atributos disponibles para el elemento multimedia.

El método getMediaAtom del objeto MediaCollection también se puede usar para recuperar el índice de un atributo determinado. Esta técnica suele ser más eficaz que los métodos getItemInfo o getItemInfoByType al trabajar con listas de reproducción grandes.

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 obtener información sobre los atributos admitidos por Reproductor multimedia de Windows, vea la referencia de atributos de Reproductor multimedia de Windows.

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.getItemInfo

Media.getItemInfoByType

Media.setItemInfo

MediaCollection.getMediaAtom

Lectura de valores de atributo

Settings.mediaAccessRights

Settings.requestMediaAccessRights