CMsgThread::PutThreadMsg

  • Article

Queues a request for execution by the worker thread.

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 Values

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.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.