Compartilhar via


Método Media.getMarkerName

[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 getMarkerName recupera o nome do marcador no índice especificado.

Sintaxe

strRetVal = Media.getMarkerName(
  markerNum
)

Parâmetros

markerNum [in]

Número (longo) especificando um índice de marcador.

Retornar valor

Esse método retorna um String.

Comentários

Esse método retornará NULL se o marcador especificado não existir.

Alguns itens de mídia digital não contêm marcadores. Use markerCount para descobrir quantos marcadores estão no clipe atual.

Os números de índice do marcador começam em 1.

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

Exemplos

O exemplo de JScript a seguir usa Mídia. getMarkerName para preencher um elemento TEXTAREA HTML chamado MNAMES com os nomes dos marcadores no item de mídia atual. O objeto Player foi criado com ID = "Player".

// Get the number of markers in the current media item.
var mcount = Player.currentMedia.markerCount;

// Verify that at least one marker exists in the current media.
if (mcount > 0){

// Loop through the marker list.
for (var i = 1; i < mcount + 1; i++){

   // Print the marker name to the text area.
   MNAMES.value += Player.currentMedia.getMarkerName(i);
   MNAMES.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.getMarkerTime

Media.markerCount

Settings.mediaAccessRights

Settings.requestMediaAccessRights