###### (This function is part of SDL_mixer, a separate library from SDL.)
# Mix_HookMusicFinished

Set a callback that runs when a music object has stopped playing.

## Header File

Defined in [<SDL3_mixer/SDL_mixer.h>](https://github.com/libsdl-org/SDL_mixer/blob/main/include/SDL3_mixer/SDL_mixer.h)

## Syntax

```c
void Mix_HookMusicFinished(Mix_MusicFinishedCallback music_finished);
```

## Function Parameters

|                                                        |                    |                                                                 |
| ------------------------------------------------------ | ------------------ | --------------------------------------------------------------- |
| [Mix_MusicFinishedCallback](Mix_MusicFinishedCallback) | **music_finished** | the callback function to become the new notification mechanism. |

## Remarks

This callback will fire when the currently-playing music has completed, or
when it has been explicitly stopped from a call to
[Mix_HaltMusic](Mix_HaltMusic). As such, this callback might fire from an
arbitrary background thread at almost any time; try to limit what you do
here.

It is legal to start a new music object playing in this callback (or
restart the one that just stopped). If the music finished normally, this
can be used to loop the music without a gap in the audio playback.

Do not call SDL_LockAudio() from this callback; you will either be inside
the audio callback, or SDL_mixer will explicitly lock the audio before
calling your callback.

A NULL pointer will disable the callback.

## Version

This function is available since SDL_mixer 3.0.0.

----
[CategoryAPI](CategoryAPI), [CategoryAPIFunction](CategoryAPIFunction)