afOpenFile - open an audio file and create a file handle structure used for
subsequent calls to the Audio File Library
AFfilehandle afOpenFile(const char *path, const char *mode,
is the path to the file to be opened.
specifies a mode for opening the file: "r" for reading or
"w" for writing.
is an AFfilesetup created by afNewFileSetup(3)
. This value
is ignored for files opened for reading except when the file format is
Upon success, afOpenFile returns a valid AFfilehandle which can be used in
subsequent calls to the Audio File Library. Upon failure, afOpenFile returns
NULL and generates an error.
is used to close the file when it is no longer needed.
afOpenFile can produce the following errors:
A call to open failed.
A call to read failed
A call to write failed.
A call to lseek failed.
Memory allocation failed.
setup specifies a file format which is unsupported for mode.
The file’s sample format is not
The file’s sample width is not
The file’s sample rate is not
The number of channels in the file is not
setup specifies an invalid or unsupported configuration.
Michael Pruett <email@example.com>