Detailed Description

The OSAPIThread is used to run code in a new thread.

Usage

• To create a thread, make a subclass of OSAPIThread and implement the virtual void Main() function in the subclass.
• To start the thread, call the Start() function.
• To stop the thread, call Stop() function.
• To free all resources allocated for the thread, call Delete() function.

Typical usage in a Component is to override the CDPComponent::Activate() and call OSAPIThread::Start() from there:

void MyComponent::Activate()
{
  CDPComponent::Activate(); // call base
  Start(CDPTHREAD_PRIORITY_HIGH,ShortName());
}

Also override CDPComponent::Suspend():

void MyComponent::Suspend()
{
  CDPComponent::Suspend();
  Stop();
  // trigger any blocking objects here, f.i. call Set() on OSAPIEvent to release a Wait().
  Delete(); // delete will block until thread is no longer running (for max. 2 seconds)
}

A typical Main() function:

void MyComponent::Main()
{
  while(!Stopped())
  {
    m_event.Wait();
    m_event.Reset();
    if(!Stopped())
      DoBlockingOperation();
  }
}