Share via


Método Media.getMarkerName

[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 getMarkerName recupera el nombre del marcador en el índice especificado.

Sintaxis

strRetVal = Media.getMarkerName(
  markerNum
)

Parámetros

markerNum [in]

Número (long) que especifica un índice de marcador.

Valor devuelto

Este método devuelve un valor String.

Observaciones

Este método devuelve NULL si el marcador especificado no existe.

Algunos elementos multimedia digitales no contienen marcadores. Use markerCount para averiguar cuántos marcadores están en el clip actual.

Los números de índice de marcador comienzan en 1.

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

Ejemplos

En el ejemplo siguiente de JScript se usa Media. getMarkerName para rellenar un elemento TEXTAREA HTML denominado MNAMES con los nombres de los marcadores del elemento multimedia actual. El objeto Player se creó con 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 Value
Versión
Reproductor multimedia de Windows versión 7.0 o posterior.
Archivo DLL
Wmp.dll

Consulte también

Media (objeto)

Media.getMarkerTime

Media.markerCount

Settings.mediaAccessRights

Settings.requestMediaAccessRights