audio_get_listener_info

Description

This function will create a ds_map and populate it with
information for the given listener.

NOTE: You are responsible for the
destruction of the returned ds_map using the appropriate
function.

The ds_map will contain the following keys:

"name" - The name of the listener, as a string, with "default"
being the standard listener name on most target platforms

"mask" - The bit-mask for the listener

"index" - The unique index value of the listener

The mask value can be used to set a sound or emitter to play
from multiple listeners at once, simply using the bitwise
or "|" to generate a mask for the sound (see the example
code below), while the index is used to set the properties like
position or velocity for a given listener using functions like
audio_listener_set_position().