Función Mix_HookMusicFinished

Sintaxis

void Mix_HookMusicFinished(void (SDLCALL *music_finished)(void));

Descripción

Establece una retrollamada que se ejecuta cuando un objeto musical ha dejado de reproducirse.

Parámetros

music_finished

La función callback para convertirse en el nuevo mecanismo de notificación.

Valor de retorno

Devuelve 0 si tiene éxito o un código de error negativo si falla. Ver SDL_GetError.

Observaciones

Esta retrollamada se activará cuando la música que se está reproduciendo haya finalizado, o cuando se haya detenido explícitamente desde una llamada a Mix_HaltMusic. Como tal, esta retrollamada podría dispararse desde un hilo de fondo arbitrario en casi cualquier momento; hay que intentar limitar lo que se hace aquí.

Es legal iniciar la reproducción de un nuevo objeto musical en esta retrollamada (o reiniciar el que acaba de detenerse). Si la música terminó normalmente, esto puede ser usado para hacer un bucle de la música sin un vacío en la reproducción de audio.

No llamar a SDL_LockAudio() desde esta retrollamada; o se estará dentro de la retrollamada de audio, o SDL_mixer bloqueará explícitamente el audio antes de llamar a esta retrollamada.

Un puntero NULL desactivará la retrollamada.