Share via

CMsgThread::PutThreadMsg

  • Article
 
Microsoft DirectShow 9.0

CMsgThread::PutThreadMsg

Queues a request for execution by the worker thread.

Syntax

  void PutThreadMsg(
    UINT uMsg,
    DWORD dwMsgFlags,
    LPVOID lpMsgParam,
    CAMEvent *pEvent = NULL
);

Parameters

uMsg

Request code.

dwMsgFlags

Optional flags parameter.

lpMsgParam

Optional pointer to a data block containing additional parameters or return values. Must be statically or heap-allocated and not automatic.

pEvent

Optional pointer to an event object to be signaled upon completion.

Return Value

No return value.

Remarks

This member function queues a request for execution by the worker thread. The parameters of this member function will be queued (in a CMsg object) and passed to the CMsgThread::ThreadMessageProc member function of the worker thread. This member function returns immediately after queuing the request and does not wait for the thread to fulfill the request. The CMsgThread::ThreadMessageProc member function of the derived class defines the four parameters.

This member function uses a multithread safe list, so multiple calls to this member function from different threads can be made safely.

Requirements

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

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

See Also