Open Sound System
OSS 4.x Programmer's Guide

Do you have problems with sound/audio application development? Don't panic! Click here for help!


Route stereo output to the specified channels (obsolete)


int binding=The desired output routing;
ioctl(fd, SNDCTL_DSP_BIND_CHANNEL, &binding);

The above code fragment lacks all error checks for clarity. Real world applications must always check for the errors and handle them as described below. Also most OSS ioctl calls will return information in the argument variable and it's usually necessary to check it too.


Note that this call is not officially part of the OSS API. It has been used by few freeware OSS implementations but it's not implemented in official OSS. Use the replacement calls instead.

Obsoleted by the following calls

Compatibility issues

This ioctl call is only used by few drivers and in general it will not be available. If this call returns errno=EINVAL then the device simply doesn't have changeable output routing. Use the replacement calls mentioned above since they are implemented by all OSS v4.0 compatible drivers.

OSS ioctl return values

The return value from the OSS ioctl calls will be -1 if a fatal error occurred. Other values mean that the ioctl call was more or less successful. However in most cases the application must check the value returned in the argument to see what was the accepted value.

Please see the Possible error codes (errno) returned by OSS calls section for more info about the error codes returned by OSS.

Sample programs

No sample programs available

Copyright (C) 4Front Technologies, 2007. All rights reserved.
Back to index OSS web site