CMsg Class

The CMsgThread class provides support for a worker thread to which requests can be posted asynchronously instead of sent directly. The CAMThread class provides a worker thread to which single requests can be sent. Only one client can make a request at a time, and the client blocks until the worker thread has completed the request. By contrast, the CMsgThread class provides a worker thread to which any number of requests can be posted. The requests (in the form of a CMsg object) are queued and executed in order, asynchronously. No reply or return value is received.

Data Members

Name	Description
dwFlags	Flag parameter to the request code.
lpParam	Data required by the worker thread as parameter or return values. This data should not be stack-based, as it will be referenced some time after completing the queuing operation.
pEvent	Event object that a worker thread can signal to indicate the completion of the operation.
uMsg	Request code that is defined by the client of the thread class and understood by the overridden worker thread function.

Member Functions

Name	Description
CMsg	Constructs a CMsg object.

---

CMsg::CMsg

CMsg Class

Constructs a CMsg object.

CMsg(
  UINT u,
  DWORD dw,
  LPVOID lp,
  CAMEvent *pEvent
  );

Parameters

u

Request code, defined by the client of the thread class and understood by the overridden worker thread function.

dw

Flag parameter to the request code.

lp

Data required by the worker thread as parameter or return values. This data should not be stack-based, as it will be referenced some time after completing the queuing operation.

pEvent

Event object that a worker thread can signal to indicate the completion of the operation.

Return Values

No return value.

Remarks

This member function contains a request for a CMsgThread worker thread to act on. All the parameters are passed to the worker thread function as parameters when this message gets processed. The meanings of the parameters are defined by the client function that calls the worker thread and the derived class that supplies the worker thread's execution function.

© 1998 Microsoft Corporation. All rights reserved. Terms of Use.

Top of Page