afSyncFile(3dm)afSyncFile(3dm)NAMEafSyncFile - write out a consistent snapshot of an audio file without
actually closing the file
SYNOPSIS
#include <dmedia/audiofile.h>
int afSyncFile(AFfilehandle file)
PARAMETER
file is the AFfilehandle structure for the audio file you want to
update. This structure is the returned value of the
afOpenFile(3dm) call.
RETURN VALUEafSyncFile() returns a negative value if an error occurs while updating
file. If no error occurs, the return value is 0.
DESCRIPTIONafSyncFile() writes out a consistent file image for file without actually
closing the file and deallocating the file structure. You can call this
routine in between calls to afWriteFrames(3dm) if you want to make sure
that the output file image always contains valid header information.
If file was opened for read-only access, afSyncFile() will simply return
0.
CAVEATS
This routine will not function correctly if the user changes the file
position on the file descriptor for the AFfilehandle being manipulated.
See the section CAVEATS FOR USING THE HANDLE'S FILE DESCRIPTOR in
afIntro(3dm) for some important information about how to deal with this
situation.
SEE ALSOafOpenFile(3dm), afCloseFile(3dm), afWriteFrames(3dm)
Page 1