blob: c9ba4e84ac23a0c5cb9a0aa8da617262d8d2f520 (
plain)
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
|
// Copyright 2014 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef IPC_MESSAGE_FILTER_H_
#define IPC_MESSAGE_FILTER_H_
#include <vector>
#include "base/memory/ref_counted.h"
#include "ipc/ipc_export.h"
namespace IPC {
class Sender;
class Message;
// A class that receives messages on the thread where the IPC channel is
// running. It can choose to prevent the default action for an IPC message.
class IPC_EXPORT MessageFilter
: public base::RefCountedThreadSafe<MessageFilter> {
public:
MessageFilter();
// Called on the background thread to provide the filter with access to the
// channel. Called when the IPC channel is initialized or when AddFilter
// is called if the channel is already initialized.
virtual void OnFilterAdded(Sender* sender);
// Called on the background thread when the filter has been removed from
// the ChannelProxy and when the Channel is closing. After a filter is
// removed, it will not be called again.
virtual void OnFilterRemoved();
// Called to inform the filter that the IPC channel is connected and we
// have received the internal Hello message from the peer.
virtual void OnChannelConnected(int32 peer_pid);
// Called when there is an error on the channel, typically that the channel
// has been closed.
virtual void OnChannelError();
// Called to inform the filter that the IPC channel will be destroyed.
// OnFilterRemoved is called immediately after this.
virtual void OnChannelClosing();
// Return true to indicate that the message was handled, or false to let
// the message be handled in the default way.
virtual bool OnMessageReceived(const Message& message);
// Called to query the Message classes supported by the filter. Return
// false to indicate that all message types should reach the filter, or true
// if the resulting contents of |supported_message_classes| may be used to
// selectively offer messages of a particular class to the filter.
virtual bool GetSupportedMessageClasses(
std::vector<uint32>* supported_message_classes) const;
protected:
virtual ~MessageFilter();
private:
friend class base::RefCountedThreadSafe<MessageFilter>;
};
} // namespace IPC
#endif // IPC_MESSAGE_FILTER_H_
|