libao version 0.8.0 - 20010804
declared in "ao/ao.h";
Open a file for audio output. The file format is determined by the
audio driver used.
- The ID number of the driver as returned by
- Name of the file in which to store the audio. The special filename "-" corresponds to stdout.
- If non-zero, the file is automatically overwritten. If zero, then a
preexisting file will cause the function to report a failure.
- Pointer to a struct describing the sample format. The caller retains ownership of this structure.
- A linked list of options to be passed to the driver or NULL if no options
are needed. Unsupported options are ignored.
non-NULL pointer inicates success. This pointer must be passed in subsequent
calls to ao_play() and
NULL indicates failure. errno will contain the specific cause of the failure:
- AO_ENODRIVER - No driver corresponds to driver_id.
- AO_ENOTFILE - This driver is not a file output driver.
- AO_EBADOPTION - A valid option key has an invalid value.
- AO_EOPENFILE - Cannot open the file.
- AO_EFILEEXISTS - The file already exists.
(Only if overwrite == 0)
- AO_EFAIL - Any other cause of failure.
Live output drivers cannot be used with this function. Use ao_open_live() instead. Some file
formats (notably .WAV) cannot be correctly written to non-seekable
files (like stdin).
When passed to ao_open_file(), the
byte_format member of an ao_sample_format struct does not
specify the byte format that will be used in the file output,
just the input sample format.