gecko/ipc/glue/nsIIPCBackgroundChildCreateCallback.h
Ben Turner 4891b5f251 Bug 956218 - '(PBackground) Add a mechanism for communicating with
a non-main I/O thread via thread and process links'. r=mrbkap+khuey+bsmedberg.
2013-11-26 23:59:41 -08:00

71 lines
3.1 KiB
C++

/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
* You can obtain one at http://mozilla.org/MPL/2.0/. */
#ifndef mozilla_ipc_nsiipcbackgroundchildcreatecallback_h
#define mozilla_ipc_nsiipcbackgroundchildcreatecallback_h
#include "mozilla/Attributes.h"
#include "nsISupports.h"
namespace mozilla {
namespace ipc {
class PBackgroundChild;
} // namespace ipc
} // namespace mozilla
#define NS_IIPCBACKGROUNDCHILDCREATECALLBACK_IID \
{0x4de01707, 0x70e3, 0x4181, {0xbc, 0x9f, 0xa3, 0xec, 0xfe, 0x74, 0x1a, 0xe3}}
class NS_NO_VTABLE nsIIPCBackgroundChildCreateCallback : public nsISupports
{
public:
typedef mozilla::ipc::PBackgroundChild PBackgroundChild;
NS_DECLARE_STATIC_IID_ACCESSOR(NS_IIPCBACKGROUNDCHILDCREATECALLBACK_IID)
// This will be called upon successful creation of a PBackgroundChild actor.
// The actor is unique per-thread and must not be shared across threads. It
// may be saved and reused on the same thread for as long as the thread lives.
// After this callback BackgroundChild::GetForCurrentThread() will return the
// same actor.
virtual void
ActorCreated(PBackgroundChild*) = 0;
// This will be called if for some reason the PBackgroundChild actor cannot be
// created. This should never be called in child processes as the failure to
// create the actor should result in the termination of the child process
// first. This may be called for cross-thread actors in the main process.
virtual void
ActorFailed() = 0;
};
NS_DEFINE_STATIC_IID_ACCESSOR(nsIIPCBackgroundChildCreateCallback,
NS_IIPCBACKGROUNDCHILDCREATECALLBACK_IID)
#define NS_DECL_NSIIPCBACKGROUNDCHILDCREATECALLBACK \
virtual void \
ActorCreated(mozilla::ipc::PBackgroundChild*) MOZ_OVERRIDE; \
virtual void \
ActorFailed() MOZ_OVERRIDE;
#define NS_FORWARD_NSIIPCBACKGROUNDCHILDCREATECALLBACK(_to) \
virtual void \
ActorCreated(mozilla::ipc::PBackgroundChild* aActor) MOZ_OVERRIDE \
{ _to ActorCreated(aActor); } \
virtual void \
ActorFailed() MOZ_OVERRIDE \
{ _to ActorFailed(); }
#define NS_FORWARD_SAFE_NSIIPCBACKGROUNDCHILDCREATECALLBACK(_to) \
virtual void \
ActorCreated(mozilla::ipc::PBackgroundChild* aActor) MOZ_OVERRIDE \
{ if (_to) { _to->ActorCreated(aActor); } } \
virtual void \
ActorFailed() MOZ_OVERRIDE \
{ if (_to) { _to->ActorFailed(); } }
#endif // mozilla_ipc_nsiipcbackgroundchildcreatecallback_h