SDL_GetAudioDeviceChannelMap(3)

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.

Availability

This function is available since SDL 3.2.0.

From libsdl3-doc 3.2.10+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.