| | Open Sound System |
| Do you have problems with sound/audio application development? Don't panic! Click here for help! |
int enabled=0 or 1; // 0 disables cooked mode and 1 enables it
ioctl(fd, SNDCTL_DSP_COOKEDMODE, &enabled);
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.
The audio device being used doesn't necessarily support the sample format, sampoling rate or number of channels that the application needs. In such cases OSS automatically converts between the format used by the application and the one supported by the device. Normally this is desired behaviour. However in some cases the application needs to disable the conversions (cooked mode). This is necessary if the application requires very precise timing. It's also necessary to turn cooked mode off when using mmap.
If the application turns of the cooked mode it must be prepared to do the conversions itself. Otherwise it will be useless with some audio devices.
This ioctl call must be made as early as possible after opening the device. Otherwise it will not have any effect. In particular the sampling rate, sample format and number of channels must be set after making this call.
Please look at the When OSS audio ioctl calls can be made section for information about DSP ioctl call ordering.
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.
| ossplay.c | Sources for the ossplay audio player and for the ossrecord |
| fulldup.c | Full duplex sample program using the single device approach. |
| mmap_duplex.c | A simple sample program for doing dull duplex using mmap |
| mmap_test.c | A sample program for using mmap() |
| multich32.c | Source file oss-testing/tutorials/sndkit/tests/multich32.c |
| multich16.c | Source file oss-testing/tutorials/sndkit/tests/multich16.c |
| ioctl_test.c | This program has been used to verify that some of the ioctl calls work |