home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3dm / audiofile / AFsyncfile.z / AFsyncfile
Encoding:
Text File  |  2002-10-03  |  2.9 KB  |  67 lines
  1.  
  2.  
  3.  
  4. aaaaffffSSSSyyyynnnnccccFFFFiiiilllleeee((((3333ddddmmmm))))                                                aaaaffffSSSSyyyynnnnccccFFFFiiiilllleeee((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      afSyncFile - write out a consistent snapshot of an audio file without
  10.      actually closing the file
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiiooooffffiiiilllleeee....hhhh>>>>
  14.  
  15.      iiiinnnntttt aaaaffffSSSSyyyynnnnccccFFFFiiiilllleeee((((AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee ffffiiiilllleeee))))
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  18.      _f_i_l_e   is the AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee structure for the audio file you want to
  19.             update.  This structure is the returned value of the
  20.             aaaaffffOOOOppppeeeennnnFFFFiiiilllleeee(3dm) call.
  21.  
  22. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  23.      aaaaffffSSSSyyyynnnnccccFFFFiiiilllleeee(((()))) returns a negative value if an error occurs while updating
  24.      _f_i_l_e. If no error occurs, the return value is 0.
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      aaaaffffSSSSyyyynnnnccccFFFFiiiilllleeee(((()))) writes out a consistent file image for _f_i_l_e without actually
  28.      closing the file and deallocating the _f_i_l_e structure.  You can call this
  29.      routine in between calls to aaaaffffWWWWrrrriiiitttteeeeFFFFrrrraaaammmmeeeessss(3dm) if you want to make sure
  30.      that the output file image always contains valid header information.
  31.  
  32.      If _f_i_l_e was opened for read-only access, aaaaffffSSSSyyyynnnnccccFFFFiiiilllleeee(((()))) will simply return
  33.      0.
  34.  
  35. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  36.      This routine will not function correctly if the user changes the file
  37.      position on the file descriptor for the AFfilehandle being manipulated.
  38.      See the section _C_A_V_E_A_T_S _F_O_R _U_S_I_N_G _T_H_E _H_A_N_D_L_E'_S _F_I_L_E _D_E_S_C_R_I_P_T_O_R in
  39.      aaaaffffIIIInnnnttttrrrroooo(3dm) for some important information about how to deal with this
  40.      situation.
  41.  
  42. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  43.      afOpenFile(3dm), afCloseFile(3dm), afWriteFrames(3dm)
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.