Controls.currentPositionTimecode

[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.

La propiedad currentPositionTimecode especifica o recupera la posición actual en el elemento multimedia actual mediante un formato de código de hora. Esta propiedad admite actualmente código de tiempo SMPTE.

player.controls.currentPositionTimecode
      

Valores posibles

Esta propiedad es una cadena de lectura y escritura.

Observaciones

El código de tiempo SMPTE proporciona una manera estándar de identificar un fotograma de vídeo individual, que resulta útil para sincronizar la reproducción. Si un archivo multimedia digital admite código de tiempo SMPTE, Reproductor multimedia de Windows puede recuperar la información de posición del código de hora actual o buscar un fotograma de vídeo identificado por una cadena de código de tiempo determinada.

El código de tiempo de SMPTE identifica un marco determinado por el número de horas, minutos, segundos y fotogramas que lo separan de un marco de referencia determinado que el marco designado como cero de tiempo. Normalmente, el período de tiempo cero es el inicio del archivo y un valor de código de tiempo SMPTE determinado representa el tiempo transcurrido desde el inicio del archivo.

El código de tiempo String tiene el formato [range]hh:mm:ss. ff donde [range] representa el intervalo, hh representa horas, mm representa minutos, ss representa segundos y ff representa fotogramas. Al especificar un valor mediante currentPositionTimecode, debe incluir los ocho dígitos con ceros como marcadores de posición.

El especificador [range] corresponde al miembro wRange de la estructura WMT_TIMECODE_EXTENSION_DATA de Windows Media Format. Para obtener más información sobre los intervalos de código de tiempo, consulte windows Media Format SDK.

La especificación y recuperación de currentPositionTimecode solo se admite para los archivos que contienen información de código de tiempo de SMPTE.

Ejemplos

En el ejemplo de código siguiente se especifica currentPositionTimecode como 1 hora, cero minutos, 30 segundos y 5 fotogramas. El objeto Player se creó con id. = "Player".

// Seek to a frame using SMPTE time code.
Player.controls.currentPositionTimecode = "[00000]01:00:30.05";

Requisitos

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

Consulte también

Controls (objeto)