1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
|
/* -*- C++ -*- */
// $Id$
// ============================================================================
//
// = LIBRARY
// ace
//
// = FILENAME
// Msg_WFMO_Reactor.h
//
// = AUTHOR
// Beskrovny Evgeny, Comverse Network Systems (evgeny_beskrovny@icomverse.com)
// Irfan Pyarali, Washington University (irfan@cs.wustl.edu)
//
// ============================================================================
#ifndef ACE_MSG_WFMO_REACTOR_H
#define ACE_MSG_WFMO_REACTOR_H
#include "ace/WFMO_Reactor.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
#if defined (ACE_WIN32)
class ACE_Export ACE_Msg_WFMO_Reactor : public ACE_WFMO_Reactor
{
//
// = TITLE
//
// An object oriented event demultiplexor and event handler
// Msg_WFMO_Reactor for Win32 MsgWaitForMultipleObjects.
//
// = DESCRIPTION
//
// The ACE_Msg_WFMO_Reactor is an object-oriented event
// demultiplexor and event handler Reactor. It differs from
// WFMO_Reactor by its ability to react on Windows messages. It
// is needed when the task should serve also as a COM/DCOM
// server.
//
public:
// = 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_Handler>s 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.
protected:
virtual int wait_for_multiple_events (int timeout,
int alertable);
// Wait for timer and I/O events to occur.
virtual DWORD poll_remaining_handles (size_t index);
// Check for activity on remaining handles.
virtual int dispatch_window_messages (void);
// Dispatches window messages.
};
#endif /* ACE_WIN32 */
#if defined (__ACE_INLINE__)
#include "ace/Msg_WFMO_Reactor.i"
#endif /* __ACE_INLINE__ */
#endif /* ACE_MSG_WFMO_REACTOR_H */
|