Share via


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

Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later