CMsgThread::PutThreadMsg

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

None.

Remarks

This member function queues a request for execution by the worker thread. The parameters of this member function are 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