]> Repos - portaudio/commitdiff
hotplug: update docs for Pa_Initialize() hotplug
authorRoss Bencina <rossb@audiomulch.com>
Sun, 18 Sep 2016 15:08:14 +0000 (01:08 +1000)
committerRoss Bencina <rossb@audiomulch.com>
Sun, 18 Sep 2016 15:08:14 +0000 (01:08 +1000)
include/portaudio.h

index 6db23fae28fb8a022c631a3b55151657a03b2612..314b159a44f65900a48275f1f61ad54bd3a2d2be 100644 (file)
@@ -158,11 +158,13 @@ const char *Pa_GetErrorText( PaError errorCode );
  If Pa_Initialize() returns an error code, Pa_Terminate() should
  NOT be called.
 
- @note The device list returned by Pa_GetDeviceCount() et al. is frozen
- when Pa_Initialize() is called. The device list is not automatically updated
- when hardware devices are connected or disconnected. To refresh the list of devices,
- either call Pa_RefreshDeviceList() or uninitialize PortAudio using Pa_Terminate(),
- and then reinitialize it by calling Pa_Initialize().
+ @note The device list returned by Pa_GetDeviceCount() et al, default devices,
+ and the default host API are all frozen when Pa_Initialize() is called. The
+ device list is not automatically updated when hardware devices are connected or
+ disconnected. To refresh the list of devices, and default devices, either call
+ Pa_RefreshDeviceList() or uninitialize PortAudio using Pa_Terminate(),
+ and then reinitialize it by calling Pa_Initialize(). To register a callback
+ when native devices or defaults change, call Pa_SetDevicesChangedCallback().
 
  @return paNoError if successful, otherwise an error code indicating the cause
  of failure.