afSyncFile(3dm)                                                afSyncFile(3dm)


NAME
     afSyncFile - 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 VALUE
     afSyncFile() returns a negative value if an error occurs while updating
     file. If no error occurs, the return value is 0.

DESCRIPTION
     afSyncFile() 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 ALSO
     afOpenFile(3dm), afCloseFile(3dm), afWriteFrames(3dm)


                                                                        Page 1