SDL_GetAudioDeviceChannelMap3
Get the current channel map of an audio device.
Usage
#include "SDL3/SDL.h"
int * SDL_GetAudioDeviceChannelMap(SDL_AudioDeviceID devid, int *count);
Header file
Defined in SDL3/SDL_audio.h
Overview
Channel maps are optional; most things do not need them, instead passing data in the [order that SDL expects](CategoryAudio#channel-layouts).
Audio devices usually have no remapping applied. This is represented by returning NULL, and does not signify an error.
Function parameters
devid
|
the instance ID of the device to query. |
|---|---|
count
|
On output, set to number of channels in the map. Can be NULL. |
Return value
Returns an array of the current channel mapping, with as many elements as the current output spec's channels, or NULL if default. This should be freed with SDL_free () when it is no longer needed.
Thread safety
It is safe to call this function from any thread.