Método Media.getAttributeName

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O método getAttributeName recupera o nome do atributo correspondente ao índice especificado.

Sintaxe

strRetVal = Media.getAttributeName(
  index
)

Parâmetros

index [in]

Número (longo) que contém o índice do atributo.

Retornar valor

Esse método retorna um String especificando o nome do atributo.

Comentários

O nome do atributo retornado pode ser usado em conjunto com getItemInfo para recuperar o valor de um atributo nomeado específico.

Para usar esse método, o acesso de leitura à biblioteca é necessário. Para obter mais informações, consulte Acesso à biblioteca.

Para obter informações sobre os atributos compatíveis com Reprodutor Multimídia do Windows, consulte a Referência de Atributo de Reprodutor Multimídia do Windows..

Reprodutor Multimídia do Windows 10 Mobile: os atributos de um item de mídia só estão disponíveis durante a reprodução, a menos que sejam recuperados do item por meio da coleção de mídia.

Exemplos

O exemplo JScript a seguir usa Mídia. getAttributeName para preencher uma área de texto HTML chamada myText com o índice e o nome de cada atributo para o item de mídia atual. O objeto Player foi criado com ID = "Player".

// Store the current media object.
var cm = Player.currentMedia;

// Get the number of attributes for the current media. 
var atCount = cm.attributeCount;

// Loop through the attribute list.
for(var i=0; i < atCount; i++){
   
   // Print each attribute index and name.   
   myText.value += "Attribute " + i +": ";
   myText.value += cm.getAttributeName(i);
   myText.value += "\n";
}

Requisitos

Requisito	Valor
Versão	Reprodutor Multimídia do Windows versão 7.0 ou posterior.
DLL	Wmp.dll

Confira também

Objeto Media

Media.attributeCount

Media.getItemInfo

Settings.mediaAccessRights

Settings.requestMediaAccessRights