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 |
|
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de