NAME
ACE_Msg_WFMO_Reactor - An OO event demultiplexor and event handler dispatcher for Win32 MsgWaitForMultipleObjects.
SYNOPSIS
#include <ace/Msg_WFMO_Reactor.h>
class ACE_Msg_WFMO_Reactor : public ACE_WFMO_Reactor
{
public:
ACE_Msg_WFMO_Reactor (
ACE_Sig_Handler * = 0,
ACE_Timer_Queue * = 0
);
ACE_Msg_WFMO_Reactor (
size_t size,
int unused = 0,
ACE_Sig_Handler * = 0,
ACE_Timer_Queue * = 0
);
virtual ~ACE_Msg_WFMO_Reactor (void);
virtual int handle_events (ACE_Time_Value *max_wait_time = 0);
virtual int alertable_handle_events (
ACE_Time_Value *max_wait_time = 0
);
virtual int handle_events (ACE_Time_Value &max_wait_time);
virtual int alertable_handle_events (
ACE_Time_Value &max_wait_time
);
protected:
virtual int wait_for_multiple_events (int timeout, int alertable);
virtual DWORD poll_remaining_handles (size_t index);
virtual int dispatch_window_messages (void);
};
DESCRIPTION
The ACE_Msg_WFMO_Reactor is an OO event demultiplexor and event handler Reactor. It differs from ACE_WFMO_Reactor by its ability to react on Windows messages. It is needed when the task should serve also as a COM/DCOM server.
Initialization and termination methods.
ACE_Msg_WFMO_Reactor (ACE_Sig_Handler * = 0, ACE_Timer_Queue * = 0);
Initialize ACE_Msg_WFMO_Reactor with the default size.
ACE_Msg_WFMO_Reactor (
size_t size,
int unused = 0,
ACE_Sig_Handler * = 0,
ACE_Timer_Queue * = 0
);
Initialize ACE_Msg_WFMO_Reactor with size size. Two slots will be added to the size parameter which will store handles used for internal management purposes.
virtual ~ACE_Msg_WFMO_Reactor (void);
Close down the ACE_Msg_WFMO_Reactor and release all of its resources.
virtual int handle_events (ACE_Time_Value *max_wait_time = 0);
virtual int alertable_handle_events (
ACE_Time_Value *max_wait_time = 0
);
This event loop driver blocks for up to max_wait_time before returning. It will return earlier if timer events, I/O events, window events, or signal events occur. Note that max_wait_time can be 0, in which case this method blocks indefinitely until events occur.
max_wait_time is decremented to reflect how much time this call took. For instance, if a time value of 3 seconds is passed to handle_events and an event occurs after 2 seconds, max_wait_time will equal 1 second. This can be used if an application wishes to handle events for some fixed amount of time.
MsgWaitForMultipleObjects is used as the demultiplexing call
Returns the total number of ACE_Event_Handlers that were dispatched, 0 if the max_wait_time elapsed without dispatching any handlers, or -1 if an error occurs.
The only difference between alertable_handle_events and handle_events is that in the alertable case, MWMO_ALERTABLE is passed to MsgWaitForMultipleObjects for the bAlertable option.
virtual int handle_events (ACE_Time_Value &max_wait_time);
virtual int alertable_handle_events (ACE_Time_Value &max_wait_time);
This method is just like the one above, except the max_wait_time value is a reference and can therefore never be NULL.
AUTHOR
Beskrovny Evgeny [email protected] and Irfan Pyarali [email protected]
LIBRARY
ace