sdlGetAudioDeviceName function audio

String? sdlGetAudioDeviceName(int devid)

Get the human-readable name of a specific audio device.

WARNING: this function will work with SDL_AUDIO_DEVICE_DEFAULT_PLAYBACK and SDL_AUDIO_DEVICE_DEFAULT_RECORDING, returning the current default physical devices' names. However, as the default device may change at any time, it is likely better to show a generic name to the user, like "System default audio device" or perhaps "default currently %s". Do not store this name to disk to reidentify the device in a later run of the program, as the default might change in general, and the string will be the name of a specific device and not the abstract system default.

\param devid the instance ID of the device to query. \returns the name of the audio device, or NULL on failure; call SDL_GetError() for more information.

\threadsafety It is safe to call this function from any thread.

\since This function is available since SDL 3.2.0.

\sa SDL_GetAudioPlaybackDevices \sa SDL_GetAudioRecordingDevices

extern SDL_DECLSPEC const char * SDLCALL SDL_GetAudioDeviceName(SDL_AudioDeviceID devid)

Implementation

String? sdlGetAudioDeviceName(int devid) {
  final sdlGetAudioDeviceNameLookupFunction = _libSdl
      .lookupFunction<
        Pointer<Utf8> Function(Uint32 devid),
        Pointer<Utf8> Function(int devid)
      >('SDL_GetAudioDeviceName');
  final result = sdlGetAudioDeviceNameLookupFunction(devid);
  if (result == nullptr) {
    return null;
  }
  return result.toDartString();
}