Método Media.getMarkerTime

[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 getMarkerTime recupera la hora del marcador en el índice especificado.

Sintaxis

retVal = Media.getMarkerTime(
  markerNum
)

Parámetros

markerNum [in]

Número (largo) que especifica el índice del marcador.

Valor devuelto

Este método devuelve un número (doble) que especifica la ubicación del marcador en segundos desde el principio del clip.

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 hay 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, vea Acceso a bibliotecas.

Ejemplos

En el siguiente ejemplo de JScript se usa Media. getMarkerTime para rellenar un elemento TEXTAREA HTML denominado MTIMES con la ubicación de cada marcador. 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 item.
if (mcount > 0){

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

   // Print the message to the text area.
   MTIMES.value += "Marker number " + i + " occurs at ";
   MTIMES.value += Player.currentMedia.getMarkerTime(i);
   MTIMES.value += " second(s).";
   MTIMES.value += "\n";
}

Requisitos

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

Consulte también

Objeto Media

Media.getMarkerName

Media.markerCount

Settings.mediaAccessRights

Settings.requestMediaAccessRights