Partager via

CMsgThread::WaitForThreadExit

  • Article
 
Microsoft DirectShow 9.0

CMsgThread::WaitForThreadExit

Blocks until the thread exits.

Syntax

  BOOL WaitForThreadExit(
    LPDWORD lpdwExitCode
);

Parameters

lpdwExitCode

Pointer to the 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

Ensure that 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. You should do this in the destructor for your derived class.

Requirements

**  Header:** Declared in Msgthrd.h; include Streams.h.

**  Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).

See Also