ACE_Msg_WFMO_Reactor Class Reference

An OO event demultiplexor and event handler dispatcher for Win32 . More...

#include <Msg_WFMO_Reactor.h>

Inheritance diagram for ACE_Msg_WFMO_Reactor:

[legend]Collaboration diagram for ACE_Msg_WFMO_Reactor:

[legend]List of all members.

Public Member Functions
	ACE_Msg_WFMO_Reactor (ACE_Sig_Handler *=0, ACE_Timer_Queue *=0)
	Initialize with the default size.
	ACE_Msg_WFMO_Reactor (size_t size, int unused=0, ACE_Sig_Handler *=0, ACE_Timer_Queue *=0)
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)
virtual int	handle_events (ACE_Time_Value &max_wait_time)
virtual int	alertable_handle_events (ACE_Time_Value &max_wait_time)
Protected Member Functions
virtual DWORD	wait_for_multiple_events (int timeout, int alertable)
	Wait for timer and I/O events to occur.
virtual DWORD	poll_remaining_handles (DWORD index)
	Check for activity on remaining handles.
virtual int	dispatch_window_messages (void)
	Dispatches window messages.

---

Detailed Description

An OO event demultiplexor and event handler dispatcher for Win32 .

The ACE_Msg_WFMO_Reactor is an OO event demultiplexor and event handler Reactor. It differs from by its ability to react on Windows messages. It is needed when the task should serve also as a COM/DCOM server.

Definition at line 42 of file Msg_WFMO_Reactor.h.

---

Constructor & Destructor Documentation

ACE_BEGIN_VERSIONED_NAMESPACE_DECL ACE_Msg_WFMO_Reactor::ACE_Msg_WFMO_Reactor (  ACE_Sig_Handler *  = 0, ACE_Timer_Queue *  = 0 )

Initialize with the default size. Definition at line 15 of file Msg_WFMO_Reactor.cpp. References ACE_Timer_Queue. : ACE_WFMO_Reactor (sh, tq) { }

ACE_Msg_WFMO_Reactor::ACE_Msg_WFMO_Reactor (  size_t  size, int  unused = 0, ACE_Sig_Handler *  = 0, ACE_Timer_Queue *  = 0 )

Initialize with size . Two slots will be added to the parameter which will store handles used for internal management purposes. Definition at line 21 of file Msg_WFMO_Reactor.cpp. References ACE_Timer_Queue. : ACE_WFMO_Reactor (size, unused, sh, tq) { }

ACE_Msg_WFMO_Reactor::~ACE_Msg_WFMO_Reactor (  void   )  [virtual]

Close down the ACE_Msg_WFMO_Reactor and release all of its resources. Definition at line 29 of file Msg_WFMO_Reactor.cpp. { }

---

Member Function Documentation

virtual int ACE_Msg_WFMO_Reactor::alertable_handle_events (  ACE_Time_Value &  max_wait_time  )  [virtual]

Reimplemented from ACE_WFMO_Reactor.

virtual int ACE_Msg_WFMO_Reactor::alertable_handle_events (  ACE_Time_Value *  max_wait_time = 0  )  [virtual]

Reimplemented from ACE_WFMO_Reactor.

int ACE_Msg_WFMO_Reactor::dispatch_window_messages (  void   )  [protected, virtual]

Dispatches window messages. Reimplemented from ACE_WFMO_Reactor. Definition at line 59 of file Msg_WFMO_Reactor.cpp. { int number_of_messages = 0; MSG msg; // Process all pending message from this thread's message queue while (::PeekMessage (&msg, 0, 0, 0, PM_REMOVE)) { ::TranslateMessage (&msg); if (msg.message == WM_QUIT) { // Should inform the main thread ::PostQuitMessage (msg.wParam); return -1; } ::DispatchMessage (&msg); ++number_of_messages; } return number_of_messages; }

virtual int ACE_Msg_WFMO_Reactor::handle_events (  ACE_Time_Value &  max_wait_time  )  [virtual]

This method is just like the one above, except the value is a reference and can therefore never be NULL. Reimplemented from ACE_WFMO_Reactor.

virtual int ACE_Msg_WFMO_Reactor::handle_events (  ACE_Time_Value *  max_wait_time = 0  )  [virtual]

This event loop driver blocks for up to before returning. It will return earlier if timer events, I/O events, window events, or signal events occur. Note that can be 0, in which case this method blocks indefinitely until events occur. 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, will equal 1 second. This can be used if an application wishes to handle events for some fixed amount of time. is used as the demultiplexing call Returns the total number of ACE_Event_Handlers that were dispatched, 0 if the elapsed without dispatching any handlers, or -1 if an error occurs. The only difference between and is that in the alertable case, MWMO_ALERTABLE is passed to for the option. Reimplemented from ACE_WFMO_Reactor.

DWORD ACE_Msg_WFMO_Reactor::poll_remaining_handles (  DWORD  index  )  [protected, virtual]

Check for activity on remaining handles. Reimplemented from ACE_WFMO_Reactor. Definition at line 83 of file Msg_WFMO_Reactor.cpp. References ACE_WFMO_Reactor_Handler_Repository::handles(). { return ::MsgWaitForMultipleObjects (this->handler_rep_.max_handlep1 () - slot, this->handler_rep_.handles () + slot, FALSE, 0, QS_ALLINPUT); }

DWORD ACE_Msg_WFMO_Reactor::wait_for_multiple_events (  int  timeout, int  alertable )  [protected, virtual]

Wait for timer and I/O events to occur. Reimplemented from ACE_WFMO_Reactor. Definition at line 34 of file Msg_WFMO_Reactor.cpp. References ACE_WFMO_Reactor_Handler_Repository::handles(). { // Wait for any of handles_ to be active, or until timeout expires. // If <alertable> is enabled allow asynchronous completion of // ReadFile and WriteFile operations. QS_ALLINPUT allows // <MsgWaitForMultipleObjectsEx> to wait for any message is in the // queue. #if (defined (ACE_HAS_WINNT4) && (ACE_HAS_WINNT4 != 0)) return ::MsgWaitForMultipleObjectsEx (this->handler_rep_.max_handlep1 (), this->handler_rep_.handles (), timeout, QS_ALLINPUT, alertable); #else ACE_UNUSED_ARG (alertable); return ::MsgWaitForMultipleObjects (this->handler_rep_.max_handlep1 (), this->handler_rep_.handles (), FALSE, timeout, QS_ALLINPUT); #endif /* (defined (ACE_HAS_WINNT4) && (ACE_HAS_WINNT4 != 0)) */ }

---

The documentation for this class was generated from the following files:

• Msg_WFMO_Reactor.h
• Msg_WFMO_Reactor.cpp

---