CMsgThread::PutThreadMsg

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

None.

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

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.