## 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.

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