Version

    Other Documentation

menu_open
Wwise SDK 2019.2.15

◆ GetDeviceList() [2/2]

AKSOUNDENGINE_API AKRESULT AK::SoundEngine::GetDeviceList ( AkUniqueID  in_audioDeviceShareSetID,
AkUInt32 io_maxNumDevices,
AkDeviceDescription out_deviceDescriptions 
)

Returns a listing of the current devices for a given sink plug-in, including Device ID, friendly name, and state. This call is only valid for sink plug-ins that support device enumeration. Prerequisites:

  • The plug-in must have been initialized by loading the init bank or by calling AK::SoundEngine::RegisterPlugin.
  • The audio device shareset must have been loaded from a soundbank and a device with this shareset must exist in the pipeline.
    Returns
    AK_NotImplemented if the sink plug-in does not implement device enumeration AK_PluginNotRegistered if the plug-in has not been registered yet either by loading the init bank or by calling RegisterPluginDLL.
Parameters
in_audioDeviceShareSetID In: The audio device shareset ID for which to list the sink plug-in devices.
io_maxNumDevices In: The maximum number of devices to write to out_deviceDescriptions. Out: Returns the number of devices that were written to out_deviceDescriptions, or if out_deviceDescriptions is NULL, how many devices would have been written.
out_deviceDescriptions The output array of device descriptions. If NULL, no devices will be written out.

Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

Tell us about your project. We're here to help.

Register your project and we'll help you get started with no strings attached!

Get started with Wwise