Previous Topic Index Next Topic
[API function]

FSOUND_READCALLBACK

Callback for reading from a file.

int F_CALLBACKAPI FSOUND_READCALLBACK(
void *buffer,
int size,
void *handle
);

Parameters

buffer You must read and copy your file data into this pointer.
length You must read this many bytes from your file data.
handle This is the handle you returned from the open callback to use for your own file routines.

Return Value

Return the number of bytes that were *successfully* read here. Normally this is just the same as 'length', but if you are at the end of the file, you will probably only read successfully the number of bytes up to the end of the file (if you tried to read more than that).

Remarks

You must read 'length' number of bytes into the 'buffer' provided, then if you need to, increment your file pointer.
___________________
Supported on the following platforms : Win32, WinCE, Linux, Macintosh, XBox, GameCube

See Also

FSOUND_CLOSECALLBACK , FSOUND_File_SetCallbacks , FSOUND_OPENCALLBACK , FSOUND_SEEKCALLBACK , FSOUND_TELLCALLBACK

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