Previous Topic Index Next Topic
[API function]

FSOUND_SEEKCALLBACK

Callback for seeking within a file.

int F_CALLBACKAPI FSOUND_SEEKCALLBACK(
void *handle,
int pos,
signed char mode
);

Parameters

handle This is the handle you returned from the open callback to use for your own file routines.
pos This is the position or offset to seek by depending on the mode.
mode This is the seek command. It uses and is compatible with SEEK_SET, SEEK_CUR and SEEK_END from stdio.h, so use them.

Return Value

If successful, the seek callback returns 0. Otherwise, it returns a nonzero value. On devices incapable of seeking, the return value is undefined.

Remarks

SEEK_END must reposition your file pointer at the END of the file, plus any negative offset. To do this you must know the size of the file, it is suggested you find and store this in the open function. Remember that a SEEK_END position value of -1 is the last byte.
You must reset your file pointer based on the commands given above.
___________________
Supported on the following platforms : Win32, WinCE, Linux, Macintosh, XBox, GameCube

See Also

FSOUND_CLOSECALLBACK , FSOUND_File_SetCallbacks , FSOUND_OPENCALLBACK , FSOUND_READCALLBACK , FSOUND_TELLCALLBACK

This document copyright ©Firelight Technologies, Pty, Ltd, 1999-2002. All rights reserved.
Generated Thu Dec 15 17:31:33 2005 by SourceDoc v0.10, the automated source code documenter.