X-Git-Url: https://git.carlh.net/gitweb/?a=blobdiff_plain;f=doc%2Fdoxygen%2Fprobe.txt;h=471b91c14de0f85746f5acabd31c16e78307836e;hb=896623a4775363c48648fdf3d88e8928040285ee;hp=a7901e96cddc590b34e245e20e6b4bd1faabc272;hpb=5536d3a2d3e64348487039c22c2b8b67b89d7a6f;p=rtaudio.git diff --git a/doc/doxygen/probe.txt b/doc/doxygen/probe.txt index a7901e9..471b91c 100644 --- a/doc/doxygen/probe.txt +++ b/doc/doxygen/probe.txt @@ -66,6 +66,8 @@ The \c nativeFormats member of the RtAudio::DeviceInfo structure is a bit mask o Some audio devices may require a minimum channel value greater than one. RtAudio will provide automatic channel number compensation when the number of channels set by the user is less than that required by the device. Channel compensation is NOT possible when the number of channels set by the user is greater than that supported by the device. -It should be noted that the capabilities reported by a device driver or underlying audio API are not always accurate and/or may be dependent on a combination of device settings. For this reason, RtAudio does not rely on the queried values when attempting to open a stream. +Note that the device enumeration is system specific and will change if any devices are plugged or unplugged by the user. Thus, the device numbers should be verified immediately before opening a stream. As well, if a user unplugs a device while an open stream is using that device, the resulting stream behaviour will be undefined (a system error will likely be generated). + +Also, the capabilities reported by a device driver or underlying audio API are not always accurate and/or may be dependent on a combination of device settings. For this reason, RtAudio does not rely on the queried values when attempting to open a stream. */