SDL_GetAudioDeviceChannelMap - Get the current channel map of an audio device.
Contents
Availability
This function is available since SDL 3.2.0.
Description
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.
Header File
Defined in SDL3/SDL_audio.h
Name
SDL_GetAudioDeviceChannelMap - Get the current channel map of an audio device.
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.
See Also
•(3), SDL_SetAudioStreamInputChannelMap(3) Simple Directmedia Layer SDL 3.2.10 SDL_GetAudioDeviceChannelMap(3)
Synopsis
#include"SDL3/SDL.h"int*SDL_GetAudioDeviceChannelMap(SDL_AudioDeviceIDdevid,int*count);
Thread Safety
It is safe to call this function from any thread.
