[Contents]

2. Interpreter Architecture

2.14. Thread Support Functions

2.14.1. thread_CreateThread

@c Create a new thread

This is a simplified implementation of the create thread interface.

The function creates a new @b{detached} thread. If the thread can not be created for some reason the return value is the error code returned by the system call pthread_start on UNIX or GetLastError on NT.

If the thread was started the return value is 0.

int thread_CreateThread(PTHREADHANDLE pThread,
                      void *pStartFunction,
                      void *pThreadParameter
  ){

• pThread is a thread handle. This should be a pointer to a variable of type THREADHANDLE. This argument is set to hold the thread handle returned by CreateThread on NT or the pointer returned as first argument of pthread_create under UNIX. This argument is not used further in this module but can be used if calling system dependant functions.
• pStartFunction should be a pointer pointing to the start function where the thread should start. This is usually just the name of the function to start in the separate thread.
• pThreadParameter is the pointer passed as argument to the start function.