| Index: ppapi/proxy/resource_message_filter.h
|
| diff --git a/ppapi/proxy/resource_message_filter.h b/ppapi/proxy/resource_message_filter.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..a7c4d263cdde819bf850156fc2d1f320675a7cac
|
| --- /dev/null
|
| +++ b/ppapi/proxy/resource_message_filter.h
|
| @@ -0,0 +1,51 @@
|
| +// Copyright 2015 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 PPAPI_PROXY_RESOURCE_MESSAGE_FILTER_H_
|
| +#define PPAPI_PROXY_RESOURCE_MESSAGE_FILTER_H_
|
| +
|
| +#include "base/memory/ref_counted.h"
|
| +#include "ppapi/proxy/ppapi_proxy_export.h"
|
| +
|
| +namespace IPC {
|
| +class Message;
|
| +}
|
| +
|
| +namespace ppapi {
|
| +namespace proxy {
|
| +class ResourceMessageReplyParams;
|
| +
|
| +// A ResourceMessageFilter lives on the IO thread and handles messages for a
|
| +// particular resource type. This is necessary in some cases where we want to
|
| +// reduce latency by doing some work on the IO thread rather than having to
|
| +// PostTask to the main Pepper thread.
|
| +//
|
| +// Note: In some cases we can rely on a reply being associated with a
|
| +// particular TrackedCallback, in which case we can dispatch directly to the
|
| +// TrackedCallback's thread. See ReplyThreadRegistrar. That should be the first
|
| +// choice for avoiding an unecessary jump to the main-thread.
|
| +//
|
| +// ResourceMessageFilter is for cases where there is not a one-to-one
|
| +// relationship between a reply message and a TrackedCallback. For example, for
|
| +// UDP Socket resources, the browser pushes data to the plugin even when the
|
| +// plugin does not have a pending callback. We can't use the
|
| +// ReplyThreadRegistrar, because data may arrive when there's not yet a
|
| +// TrackedCallback to tell us what thread to use. So instead, we define a
|
| +// UDPSocketFilter which accepts and queues UDP data on the IO thread.
|
| +class PPAPI_PROXY_EXPORT ResourceMessageFilter
|
| + : public base::RefCountedThreadSafe<ResourceMessageFilter> {
|
| + public:
|
| + virtual bool OnResourceReplyReceived(
|
| + const ResourceMessageReplyParams& reply_params,
|
| + const IPC::Message& nested_msg) = 0;
|
| +
|
| + protected:
|
| + friend class base::RefCountedThreadSafe<ResourceMessageFilter>;
|
| + virtual ~ResourceMessageFilter() {}
|
| +};
|
| +
|
| +} // namespace proxy
|
| +} // namespace ppapi
|
| +
|
| +#endif // PPAPI_PROXY_RESOURCE_MESSAGE_FILTER_H_
|
|
|