audio: Allow SDL_GetAudioDeviceFormat() to query the default devices.

Officially removed SDL_GetDefaultAudioInfo(), as its functionality that
isn't obsolete is now offered elsewhere.
This commit is contained in:
Ryan C. Gordon
2023-06-23 14:32:25 -04:00
parent ee10bab3cd
commit db39cbf208
3 changed files with 22 additions and 0 deletions

View File

@@ -321,6 +321,11 @@ extern DECLSPEC char *SDLCALL SDL_GetAudioDeviceName(SDL_AudioDeviceID devid);
* the device's preferred format (or a reasonable default if this
* can't be determined).
*
* You may also specify SDL_AUDIO_DEVICE_DEFAULT_OUTPUT or
* SDL_AUDIO_DEVICE_DEFAULT_CAPTURE here, which is useful for getting
* a reasonable recommendation before opening the system-recommended
* default device.
*
* \param devid the instance ID of the device to query.
* \param spec On return, will be filled with device details.
* \returns 0 on success or a negative error code on failure; call