[Media Router] Adds return value to mojo MediaRouteProvider::TerminateRoute.

chrome/browser/media/router/mojo/media_router.mojom

 // 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.
 
 module media_router.interfaces;
 
 // Represents an output sink to which media can be routed.
 struct MediaSink {
   enum IconType {
     CAST,
@@ skipping 104 matching lines @@
 };
 
 struct SinkSearchCriteria {
   // Input to the search method which each Media Route Provider may interpret
   // differently.
   string input;
   // The user's current hosted domain.
   string domain;
 };
 
-// Maps to a ResultCode value in route_request_result.h
-// The enum defined here is a subset of those defined in route_request_result.h.
+// Keep in sync with:
+// - RouteRequestResult::ResultCode in route_request_result.h
+// - MediaRouteProviderResult enum in tools/metrics/histograms.xml.
+// - mr.RouteRequestResultCode in route_request_error.js
 enum RouteRequestResultCode {
   UNKNOWN_ERROR,
   OK,
   TIMED_OUT,
-  ROUTE_NOT_FOUND
+  ROUTE_NOT_FOUND,
+  SINK_NOT_FOUND,
+  INVALID_ORIGIN,
+  OFF_THE_RECORD_MISMATCH,
+  NO_SUPPORTED_PROVIDER
+// New values must be added here.
 };
 
 // Modeled after the MediaRouter interface defined in
 // chrome/browser/media/router/media_router.h
 interface MediaRouteProvider {
   // Creates a media route from |media_source| to the sink given by |sink_id|.
   //
   // The presentation ID of the route created will be |presentation_id|, but it
   // may be overridden by a provider implementation. The presentation ID will
   // be used by the presentation API to refer to the created route.
@@ skipping 80 matching lines @@
                         string route_id,
                         string presentation_id,
                         string origin,
                         int32 tab_id,
                         int64 timeout_millis,
                         bool off_the_record) =>
                             (MediaRoute? route,
                              string? error_text,
                              RouteRequestResultCode result_code);
 
-  // Terminates the route specified by |route_id|.
-  TerminateRoute(string route_id);
+  // Terminates the route specified by |route_id|.  If the route was terminated
+  // successfully, |result_code| is set to OK and |error_text| is null.
+  // Otherwise, |result_code| is an error code and |error_text| describes the
+  // error.
+  TerminateRoute(string route_id) =>
+      (string? error_text, RouteRequestResultCode result_code);
 
   // Sends |message| via the media route |media_route_id|.
   // If the operation was successful, |sent| is true; otherwise it is false.
   SendRouteMessage(string media_route_id, string message) => (bool sent);
 
   // Sends |data| via the media route |media_route_id|.
   // If the operation was successful, |sent| is true; otherwise it is false.
   SendRouteBinaryMessage(string media_route_id, array<uint8> data)
       => (bool sent);
 
@@ skipping 131 matching lines @@
   // Called when the a batch of messages arrives from the media sink for the
   // route given by |route_id|.
   // |StartListeningForRouteMessages| must be called first in order to receive
   // messages.
   // |route_id|: ID of route of the messages.
   // |messages|: A non-empty list of messages received.
   OnRouteMessagesReceived(string route_id,
                           array<RouteMessage> messages);
 };