Definition:

#include <aIO.h>#include <aStem.h>
object code: aStem shared library



aLIBRETURN aStem_CreateTEAFileOutput(

aStemLib stemRef, unsigned char address, const unsigned int nFileNumber, aStreamRef* pStreamRef, aErr* pErr);

Parameters:

stemRef	-	A pointer to the opaque stem reference used for getting the file output stream.
address	-	The address of the BrainStem module the stream will output to.
nFileNumber	-	The file number of the file that is to be written to the addressed module.
pStreamRef	-	A pointer to a stream reference that is set to the newly created output stream.
pErr	-	A pointer to an aErr variable that recieves the error code on exit from this routine.

Return Value:

This library routine returns an aLIBRETURN type that is non-zero if there are errors, and zero if the routine completes with no errors.

Description:

This routine sets up an output stream to the requested module and file.  A TEA file can be written to the module using the stream this routine creates.  Reads from this stream will result in an aErrMode error.

Related:

aStem_CreateTEAFileInput, aStream_Destroy, cmdTEAINIT, cmdTEADATA, cmdTEAEOF