Updated documentation now that SDL_GetAudioDevices() has been split into separate functions for output and capture devices

main
Sam Lantinga 2023-08-26 17:30:57 -07:00
parent 506a133d84
commit 615824a806
1 changed files with 2 additions and 2 deletions

View File

@ -125,13 +125,13 @@ Devices are not opened by an arbitrary string name anymore, but by device instan
Many functions that would accept a device index and an `iscapture` parameter now just take an SDL_AudioDeviceID, as they are unique across all devices, instead of separate indices into output and capture device lists. Many functions that would accept a device index and an `iscapture` parameter now just take an SDL_AudioDeviceID, as they are unique across all devices, instead of separate indices into output and capture device lists.
Rather than iterating over audio devices using a device index, there is a new function, SDL_GetAudioDevices(), to get the current list of devices, and new functions to get information about devices from their instance ID: Rather than iterating over audio devices using a device index, there are new functions, SDL_GetAudioOutputDevices() and SDL_GetAudioCaptureDevices(), to get the current list of devices, and new functions to get information about devices from their instance ID:
```c ```c
{ {
if (SDL_InitSubSystem(SDL_INIT_AUDIO) == 0) { if (SDL_InitSubSystem(SDL_INIT_AUDIO) == 0) {
int i, num_devices; int i, num_devices;
SDL_AudioDeviceID *devices = SDL_GetAudioDevices(/*iscapture=*/SDL_FALSE, &num_devices); SDL_AudioDeviceID *devices = SDL_GetAudioOutputDevices(&num_devices);
if (devices) { if (devices) {
for (i = 0; i < num_devices; ++i) { for (i = 0; i < num_devices; ++i) {
SDL_AudioDeviceID instance_id = devices[i]; SDL_AudioDeviceID instance_id = devices[i];