afSyncFile(3dm)						       afSyncFile(3dm)

NAME    [Toc]    [Back]

     afSyncFile	- write	out a consistent snapshot of an	audio file without
     actually closing the file

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audiofile.h>

     int afSyncFile(AFfilehandle file)

PARAMETER    [Toc]    [Back]

     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    [Toc]    [Back]

     afSyncFile() returns a negative value if an error occurs while updating
     file. If no error occurs, the return value	is 0.

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     afOpenFile(3dm), afCloseFile(3dm),	afWriteFrames(3dm)
afSyncFile(3dm)						       afSyncFile(3dm)

NAME    [Toc]    [Back]

     afSyncFile	- write	out a consistent snapshot of an	audio file without
     actually closing the file

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audiofile.h>

     int afSyncFile(AFfilehandle file)

PARAMETER    [Toc]    [Back]

     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    [Toc]    [Back]

     afSyncFile() returns a negative value if an error occurs while updating
     file. If no error occurs, the return value	is 0.

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     afOpenFile(3dm), afCloseFile(3dm),	afWriteFrames(3dm)


									PPPPaaaaggggeeee 1111