Método MediaCollection.getMediaAtom

[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 getMediaAtom recupera el índice en el que reside un atributo especificado dentro del conjunto de atributos disponibles.

Sintaxis

retVal = MediaCollection.getMediaAtom(
  attribute
)

Parámetros

atributo [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 un valor Number (long).

Observaciones

El número de índice recuperado con este método se puede pasar al medio. Método getItemInfoByAtom para tener acceso a los valores de atributo. Esta técnica suele ser más eficaz cuando se trabaja con listas de reproducción de gran tamaño que el acceso a un valor de atributo por nombre a través de Media. getItemInfo o Media. getItemInfoByType.

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

Requisitos

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

Consulte también

Media.getItemInfo

Media.getItemInfoByAtom

Media.getItemInfoByType

Objeto MediaCollection

Settings.mediaAccessRights

Settings.requestMediaAccessRights