[Media Router] Wiring for searching route providers for new sinks.

chrome/browser/media/router/media_router.h

 // 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 CHROME_BROWSER_MEDIA_ROUTER_MEDIA_ROUTER_H_
 #define CHROME_BROWSER_MEDIA_ROUTER_MEDIA_ROUTER_H_
 
 #include <stdint.h>
 
 #include <string>
@@ skipping 13 matching lines @@
 
 namespace content {
 class WebContents;
 }
 
 namespace media_router {
 
 class IssuesObserver;
 class MediaRoutesObserver;
 class MediaSinksObserver;
+class MediaSinksSearchRequest;
 class PresentationConnectionStateObserver;
 class PresentationSessionMessagesObserver;
+class QueryResultManager;
 class RouteRequestResult;
 
 // Type of callback used in |CreateRoute()|, |JoinRoute()|, and
 // |ConnectRouteByRouteId()|. Callback is invoked when the route request either
 // succeeded or failed.
 using MediaRouteResponseCallback =
     base::Callback<void(const RouteRequestResult& result)>;
 
 // Subscription object returned by calling
 // |AddPresentationConnectionStateChangedCallback|. See the method comments for
@@ skipping 111 matching lines @@
   AddPresentationConnectionStateChangedCallback(
       const MediaRoute::Id& route_id,
       const content::PresentationConnectionStateChangedCallback& callback) = 0;
 
  private:
   friend class IssuesObserver;
   friend class MediaSinksObserver;
   friend class MediaRoutesObserver;
   friend class PresentationConnectionStateObserver;
   friend class PresentationSessionMessagesObserver;
+  friend class QueryResultManager;
 
   // The following functions are called by friend Observer classes above.
 
   // Registers |observer| with this MediaRouter. |observer| specifies a media
   // source and will receive updates with media sinks that are compatible with
   // that source. The initial update may happen synchronously.
   // NOTE: This class does not assume ownership of |observer|. Callers must
   // manage |observer| and make sure |UnregisterObserver()| is called
   // before the observer is destroyed.
   // It is invalid to register the same observer more than once and will result
   // in undefined behavior.
   // If the MRPM Host is not available, the registration request will fail
   // immediately.
   // The implementation can reject the request to observe in which case it will
   // notify the caller by returning |false|.
   virtual bool RegisterMediaSinksObserver(MediaSinksObserver* observer) = 0;
 
   // Removes a previously added MediaSinksObserver. |observer| will stop
   // receiving further updates.
   virtual void UnregisterMediaSinksObserver(MediaSinksObserver* observer) = 0;
 
+  // Registers |request| with this MediaRouter. |request| specifies a media
+  // source and a sink ID. The MediaRouter will ask the Media Router Provider
+  // Manager to search for sinks matching the sink ID that also support the
+  // media source. |request| will be notified when the MRPM responds and then it
+  // will be destroyed.
+  // Multiple requests can be registered for the same sink ID. Only one query
+  // per sink ID will be pending at one time.
+  // The implementation can reject the request to search in which case it will
+  // notify the caller by returning |false|.
+  virtual bool RegisterMediaSinksSearchRequest(
+      scoped_ptr<MediaSinksSearchRequest> request) = 0;
+
   // Adds a MediaRoutesObserver to listen for updates on MediaRoutes.
   // The initial update may happen synchronously.
   // MediaRouter does not own |observer|. |UnregisterMediaRoutesObserver| should
   // be called before |observer| is destroyed.
   // It is invalid to register the same observer more than once and will result
   // in undefined behavior.
   virtual void RegisterMediaRoutesObserver(MediaRoutesObserver* observer) = 0;
 
   // Removes a previously added MediaRoutesObserver. |observer| will stop
   // receiving further updates.
@@ skipping 18 matching lines @@
 
   // Unregisters a previously registered PresentationSessionMessagesObserver.
   // |observer| will stop receiving further updates.
   virtual void UnregisterPresentationSessionMessagesObserver(
       PresentationSessionMessagesObserver* observer) = 0;
 };
 
 }  // namespace media_router
 
 #endif  // CHROME_BROWSER_MEDIA_ROUTER_MEDIA_ROUTER_H_