Definition:

#include <aTEAvm.h>
object code: aTEAvm shared library



aLIBRETURN aTEAvm_Initialize(

teavmRef teavmRef, unsigned int nMaxStackSize, unsigned int nMaxProcesses, aTEAVMIOPortProc portCBProc, void* portCBRef, aErr* pErr);

Parameters:

teavmRef	-	A pointer to the opaque library reference of the TEA virtual machine.
nMaxStackSize	-	The maximum stack size (in bytes) for all the processes run in the TEA virtual machine.
nMaxProcesses	-	The maximum number of processes that can simultaneously run in the TEA virtual machine.
portCBProc	-	The callback routine that provides access to your port implementation.  Some ports are automatically handled, the others call this callback for handling outside the TEA virtual machine.
portCBRef	-	An opaque reference sent to the port callback that can be used to store implementation specific data.
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 the virtual machine for subsequent calls to aTEAvm_Launch that initiate processes in the virtual machine.  The parameters allow you to specify the size and number of virtual machines as well as how port accesses are handled from within the virtual machines.

Related:

aTEAvm_Launch