SDL Wiki
[ front page | index | search | recent changes | git repo | offline html ]
(This function is part of SDL_mixer, a separate library from SDL.)

MIX_GetTrackAudioStream

Query the SDL_AudioStream assigned to a track.

Header File

Defined in <SDL3_mixer/SDL_mixer.h>

Syntax

SDL_AudioStream * MIX_GetTrackAudioStream(MIX_Track *track);

Function Parameters

MIX_Track * track the track to query.

Return Value

(SDL_AudioStream *) Returns an SDL_AudioStream if available, NULL if not.

Remarks

This returns the SDL_AudioStream object currently assigned to track through a call to MIX_SetTrackAudioStream(). If there is none assigned, or the track has an input that isn't an SDL_AudioStream (such as a MIX_Audio or SDL_IOStream), this will return NULL.

On various errors (MIX_Init() was not called, the track is NULL), this returns NULL, but there is no mechanism to distinguish errors from tracks without a valid input.

Thread Safety

It is safe to call this function from any thread.

Version

This function is available since SDL_mixer 3.0.0.

See Also


CategoryAPI, CategoryAPIFunction, CategorySDLMixer


[ edit | delete | history | feedback | raw ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.