[mojo-edk] Expose notification source to MojoWatch callbacks

mojo/public/cpp/bindings/binding.h

 // 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 MOJO_PUBLIC_CPP_BINDINGS_BINDING_H_
 #define MOJO_PUBLIC_CPP_BINDINGS_BINDING_H_
 
 #include <utility>
 
 #include "base/macros.h"
@@ skipping 190 matching lines @@
   MessagePipeHandle handle() const { return internal_state_.handle(); }
 
   // Returns the associated group that this object belongs to. Returns null if:
   //   - this object is not bound; or
   //   - the interface doesn't have methods to pass associated interface
   //     pointers or requests.
   AssociatedGroup* associated_group() {
     return internal_state_.associated_group();
   }
 
+  // Allows immediate, synchronous dispatch of any incoming method call elicited
+  // by an event on the Binding's own thread. This is useful for efficiency when
+  // a Binding lives on the same thread that's running Mojo IPC Support (e.g.
+  // Chrome's IO thread) because there's no risk of subtle reentrancy issues in
+  // interface implementations.
+  //
+  // This may also be used in testing when, e.g., an InterfacePtr and Binding
+  // live on the same thread and you want synchronous behavior for messages that
+  // are asynchronous under normal conditions.
+  //
+  // Note that this option also affects all endpoints which are associated with
+  // this one and which live on the same thread.
+  void EnableImmediateDispatchOfEventsFromSameThread(bool enabled) {
+    internal_state_.EnableImmediateDispatchOfEventsFromSameThread(enabled);
+  }
+
   // Exposed for testing, should not generally be used.
   void EnableTestingMode() { internal_state_.EnableTestingMode(); }
 
  private:
   internal::BindingState<Interface, Interface::PassesAssociatedKinds_>
       internal_state_;
 
   DISALLOW_COPY_AND_ASSIGN(Binding);
 };
 
 }  // namespace mojo
 
 #endif  // MOJO_PUBLIC_CPP_BINDINGS_BINDING_H_