Return to readme CVS log

Up to [WindowsNT SDKs] / q_a / samples / threads

Microsoft Windows NT Build 297 06-28-1992

 Sample: Using Thread API Functions
Summary:

The THREADS sample application shows how to use
SetThreadPriority, SuspendThread, and ResumeThread.

More Information:

To use THREAD, start the application. Two threads will be
created; one will draw a red rectangle and the other a green
rectangle. Both of these rectangles move about the window;
their speed and behavior is based on the thread priority and
its resumed/suspended status. The priority and status are
set through menu selections.

Of special interest is the suspension count. The system
keeps track of the number of times a thread has been
suspended and resumed. Each time the thread is suspended,
the count is incremented; each time it is resumed, the count
is decremented. The suspension count can either be tracked
by applications manually, the same way this sample
application does, or the return value from ResumeThread and
SuspendThread can be used to obtain the previous suspension
count before the call was made. Only when the suspension
count is zero will the thread run.

A thread has only five priorities that you are allowed to
use:

   THREAD_PRIORITY_LOWEST
   THREAD_PRIORITY_BELOW_NORMAL
   THREAD_PRIORITY_NORMAL
   THREAD_PRIORITY_ABOVE_NORMAL
   THREAD_PRIORITY_HIGHEST

Other priorities are reserved for use by the system only.

The following is a list of the Win32 API functions used in
this sample:

   CreateSolidBr  GetMessage     Rectangle      Sleep
   ush
   CreateThread   GetStockObjec  RegisterClass  SuspendThread
                  t
   CreateWindow   GetSystemTime  ReleaseDC      TerminateThre
                                                ad
   DispatchMessa  LoadCursor     ResumeThread   wsprintf
   ge
   GetClientRect  LoadIcon       SelectObject   
   GetDC          MessageBox     SetThreadPrio  
                                 rity
   GetLastError   PostQuitMessa  ShowWindow     
                  ge

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.