PCCOMABORT()

void PCCOMABORT(void);

This routine aborts the current file transfer operation being carried out by the PCCom library. It is the third entry point in the PCCom library.

Include: pccom.goh

PCCOMEXIT()

PCComReturnType PCCOMEXIT();

This routine kills a pccom thread such as those started by PCCOMINIT(). It is the second entry point in the PCCom library.

Structures:

        typedef ByteEnum PCComReturnType;
        #define PCCRT_NO_ERROR 0
        #define PCCRT_CANNOT_LOAD_SERIAL_DRIVER 1
        #define PCCRT_CANNOT_CREATE_THREAD 2
        #define PCCRT_CANNOT_ALLOC_STREAM 3
        #define PCCRT_ALREADY_INITIALIZED 4

Include: pccom.goh

PCCOMINIT()

PCComReturnType PCCOMINIT(
        SerialPortNum 		port,
        SerialBaud 		baud,
        word 		timeout,
        optr 		callbackOptr,
        PCComInitFlags 		flags);

This entry point of the PCCom library spawns a new thread which monitors a serial port and acts as a passive pccom terminal. This routine is the first entry point in the PCCom library.

This routine takes the following arguments:

port: A SerialPortNum value specifying which serial port to use for the pccom connection. Pass -1 for the system default value: com1 for the Zoomer, com2 for the desktop product.
baud: A SerialBaud value specifying what speed to use. Pass -1 for the system default value: 19200 baud for the Zoomer, 38400 baud for the desktop product.
timeout: Number of clock ticks (one tick is 1/60 second) to allow for connection.
callbackOptr: An object which will receive notification messages of certain events. A value of zero means no notification will be sent.
flags: If an object will be receiving notification messages, these flags determine what sort of notifications will be sent.

Structures:

        typedef ByteEnum PCComReturnType;
        #define PCCRT_NO_ERROR 0
        #define PCCRT_CANNOT_LOAD_SERIAL_DRIVER 1
        #define PCCRT_CANNOT_CREATE_THREAD 2
        #define PCCRT_CANNOT_ALLOC_STREAM 3
        #define PCCRT_ALREADY_INITIALIZED 4
         
        typedef WordFlags PCComInitFlags;
        	/* send notifications when text is available for display */
        #define PCCIF_NOTIFY_OUTPUT 0x8000
        	/* send notification when the remote machine shuts down the
 * serial line */

        #define PCCIF_NOTIFY_EXIT 0x4000

Include: pccom.goh

ProcCallFixedOrMovable_cdecl()

dword	ProcCallFixedOrMovable_cdecl(
        void 	(*routine),
        ...)

This routine calls the routine pointed to, passing the other arguments through to the called routine. The called routine must use C calling conventions.

Include: resource.h

ProcCallFixedOrMovable_pascal()

dword	ProcCallFixedOrMovable_pascal(
        ...,
        void 	(*routine))

This routine calls the routine pointed to, passing the other arguments through to the called routine. The called routine must use Pascal calling conventions.

Include: resource.h

ProcGetLibraryEntry()

void *	ProcGetLibraryEntry(
        GeodeHandle		library,
        word		entryNumber)

This routine returns the pointer to a library's entry-point.

Include: resource.h

ProcInfo()

ThreadHandle ProcInfo(
        GeodeHandle gh);		/* handle of geode to check */

This routine returns the first thread of the process geode specified. If the geode is not a process, the routine will return a null handle.

Include: geode.h

PtrToOffset()

word	PtrToOffset(ptr);
        dword	ptr;

This macro returns just the lower 16 bits of the given dword. It is most useful for extracting the offset portion of a far pointer.

PtrToSegment()

word	PtrToSegment(ptr);
        dword	ptr;

This macro returns just the upper 16 bits of the given dword. It is most useful for extracting the segment address of a far pointer.