diff options
| author | Alexandre Ratchov <ratchov@cvs.openbsd.org> | 2019-01-18 08:43:50 +0000 |
|---|---|---|
| committer | Alexandre Ratchov <ratchov@cvs.openbsd.org> | 2019-01-18 08:43:50 +0000 |
| commit | d73018db5307861761e822495245ecffaf6c48ed (patch) | |
| tree | c328f087c1b8ae565a3ae7aa454bc62eaa4aea9e /lib | |
| parent | dee031cfdeb16ebc49a17e5b2b9f2576d7e06957 (diff) | |
Sayt that using capabilities to negociate audio parameters (ie using
sio_getcap() function) is not recomended.
From Paul Swanson <psw at protonmail.com>, ok jmc
Diffstat (limited to 'lib')
| -rw-r--r-- | lib/libsndio/sio_open.3 | 14 |
1 files changed, 12 insertions, 2 deletions
diff --git a/lib/libsndio/sio_open.3 b/lib/libsndio/sio_open.3 index fc5b68edba0..e52d18e55d8 100644 --- a/lib/libsndio/sio_open.3 +++ b/lib/libsndio/sio_open.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sio_open.3,v 1.47 2018/07/28 09:11:55 ratchov Exp $ +.\" $OpenBSD: sio_open.3,v 1.48 2019/01/18 08:43:49 ratchov Exp $ .\" .\" Copyright (c) 2007 Alexandre Ratchov <alex@caoua.org> .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: July 28 2018 $ +.Dd $Mdocdate: January 18 2019 $ .Dt SIO_OPEN 3 .Os .Sh NAME @@ -284,6 +284,11 @@ Applications that need to have a set of working parameter combinations in advance can use the .Fn sio_getcap function. +However, for most new applications it's generally +not recommended to use +.Fn sio_getcap . +Instead, follow the recommendations for negotiating +device parameters (see above). .Pp The .Vt sio_cap @@ -367,6 +372,11 @@ structure, then the second element of the array of the .Vt sio_cap structure is valid for this configuration. +As such, when reading the array elements in the +.Vt sio_cap +structure, the corresponding +.Vt sio_conf +bitmasks should always be used. .El .Ss Starting and stopping the device The |