GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  AFOPENFILE (3)

.ds Aq ’

NAME

afOpenFile - open an audio file and create a file handle structure used for subsequent calls to the Audio File Library

CONTENTS

SYNOPSIS

#include <audiofile.h>

AFfilehandle afOpenFile(const char *path, const char *mode,
    AFfilesetup setup);

PARAMETERS

path is the path to the file to be opened.

mode specifies a mode for opening the file: "r" for reading or "w" for writing.

setup is an AFfilesetup created by afNewFileSetup(3). This value is ignored for files opened for reading except when the file format is AF_FILE_RAWDATA.

RETURN VALUE

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.

afCloseFile(3) is used to close the file when it is no longer needed.

ERRORS

afOpenFile can produce the following errors:

AF_BAD_OPEN

A call to open failed.

AF_BAD_READ

A call to read failed

AF_BAD_WRITE

A call to write failed.

AF_BAD_LSEEK

A call to lseek failed.

AF_BAD_MALLOC

Memory allocation failed.

AF_BAD_FILEFMT

setup specifies a file format which is unsupported for mode.

AF_BAD_SAMPFMT

The file\(cqs sample format is not supported.

AF_BAD_WIDTH

The file\(cqs sample width is not supported.

AF_BAD_RATE

The file\(cqs sample rate is not supported.

AF_BAD_CHANNELS

The number of channels in the file is not supported.

AF_BAD_FILESETUP

setup specifies an invalid or unsupported configuration.

SEE ALSO

afCloseFile(3), afNewFileSetup(3), afInitFileFormat(3), afInitSampleFormat(3), afReadFrames(3), afWriteFrames(3)

AUTHOR

Michael Pruett <michael@68k.org>

Search for    or go to Top of page |  Section 3 |  Main Index


Audio File Library 0&.3&.6 AFOPENFILE (3) 03/06/2013

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.