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
AFSEEKFRAME(3)   AFSEEKFRAME(3)

afSeekFrame, afTellFrame - update or access the current sample frame position for a track in an audio file

#include <audiofile.h>

AFframecount afSeekFrame(AFfilehandle file, int track,
    AFframecount frameOffset);

AFframecount afTellFrame(AFfilehandle file, int track);

file is a valid audio file handle created by afOpenFile(3).

track identifies an audio track within the file. track is always AF_DEFAULT_TRACK for all currently supported audio file formats.

frameOffset is a sample frame offset. Valid sample frame offsets must be greater than or equal to zero and strictly less than the number of sample frames contained within the specified audio track. The special value -1 is also allowed.

afSeekFrame moves the logical file position for a specified audio track to a desired sample frame location. If frameOffset is -1, afSeekFrame will not modify the current file offset and will instead return the current file position.

afTellFrame returns current file position in sample frames.

On success, afSeekFrame and afTellFrame will return the current file position as measured in sample frames from the start of the audio track. On failure, afSeekFrame and afTellFrame will return the value -1.

The following errors can be generated by afSeekFrame or afTellFrame:

AF_BAD_FILEHANDLE

file does not represent a valid file handle.

AF_BAD_TRACK

track does not identify a valid track.

AF_BAD_LSEEK

A call to lseek failed.

Michael Pruett <michael@68k.org>
03/06/2013 Audio File Library 0.3.6

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

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