Share via


CMsgThread::WaitForThreadExit (Compact 2013)

3/26/2014

Blocks until the thread exits.

Syntax

BOOL WaitForThreadExit(
  LPDWORD lpdwExitCode 
);

Parameters

  • lpdwExitCode
    Exit code returned by the thread.

Return Value

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

Header

dshow.h,
Streams.h

Library

ole32.lib,
Ole32auth.lib,
Strmbase.lib,
Strmiids.lib,
uuid.lib

See Also

Reference

CMsgThread Class