Version

menu_open
Warning: you were redirected to the latest documentation corresponding to your major release ( 2022.1.17.8543 ). Should you wish to access your specific version's documentation, please download the offline documentation from the Audiokinetic Launcher and check the Offline Documentation option in Wwise Authoring.
Wwise SDK 2022.1.17

◆ GetDeviceList() [1/2]

AKSOUNDENGINE_API AKRESULT AK::SoundEngine::GetDeviceList ( AkUInt32  in_ulCompanyID,
AkUInt32  in_ulPluginID,
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.

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.
  • AK_NotCompatible if no device of this type are supported on the current platform
  • AK_Fail in case of system device manager failure (OS related)
Parameters
in_ulCompanyIDCompany identifier (as declared in the plug-in description XML file)
in_ulPluginIDPlug-in identifier (as declared in the plug-in description XML file)
io_maxNumDevicesIn: The length of the out_deviceDescriptions array. Out: If out_deviceDescriptions is not-null, this will be set to the number of entries in out_deviceDescriptions that was populated. If out_deviceDescriptions is null, this will be set to the number of devices that may be available.
out_deviceDescriptionsThe output array of device descriptions.

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