osStartThread.3p 1.03 KB
.TH osStartThread 3P local "Silicon Graphics, Inc."
.SH NAME
.upperok
osStartThread \- start or resume a thread
.SH SYNOPSIS
.nf
\f3
.Op c
#include <ultra64.h>
.sp .8v
void osStartThread(OSThread \(**t);
.Op
\f1
.fi
.SH DESCRIPTION
The
.I osStartThread
call will make a thread created by
.I osCreateThread
runnable for the first time,
or will resume a thread previously suspend by
.IR osStopThread .
In the former case,
.I osStartThread
call will enqueue the given thread
.I t
onto the run queue.
In the latter,
.I osStartThread
will reinsert the given thread back onto the queue it was on at the
time of
.I osStopThread
was called.
In either case,
if the thread is made runnable and if the thread has a higher priority than
the invoking thread,
the currently running thread will immediately yield the CPU to the started
thread.
.PP
See
.IR osStopThread (3P)
for a discussion of the side effects of this implementation.
.SH "SEE ALSO"
.IR osCreateThread (3P),
.IR osGetThreadId (3P),
.IR osGetThreadPri (3P),
.IR osStopThread (3P),
.IR osYieldThread (3P)