CMsgThread::WaitForThreadExit (Windows CE 5.0)

Send Feedback

Blocks until the thread exits.

BOOL WaitForThreadExit(LPDWORDlpdwExitCode);

Parameters

  • lpdwExitCode
    Exit code returned by the thread.

Return Values

Returns either TRUE or FALSE, the meaning of which is determined by the class supplying the overridden CMsgThread::ThreadMessageProc member function and the calling member function.

Remarks

Be sure the worker thread has exited completely before completing the destruction of your derived class; otherwise, the thread might still execute after your dynamic-link library (DLL) has been unloaded from the address space of the process.

Even if the only instruction left to exit is a single-return instruction, this would cause an exception.

The only reliable way to ensure that the thread has exited is to signal the thread to exit (using a privately negotiated CMsg object sent to the CMsgThread::PutThreadMsg member function) and then call this member function.

Do this in the destructor for your derived class.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements.

For more information, see Setting Up the Build Environment.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.