1 /* 2 * Copyright (C) 2008 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package com.android.phone; 18 19 import com.android.phone.INetworkQueryServiceCallback; 20 21 /** 22 * Service interface to handle queries for available networks. The 23 * Phone application lets this service interface handle carrier 24 * availability queries instead of making direct calls to the 25 * GSMPhone layer. 26 */ 27 oneway interface INetworkQueryService { 28 29 /** 30 * Starts a network query if it has not been started yet, and 31 * request a callback through the INetworkQueryServiceCallback 32 * object on query completion. If there is an existing request, 33 * then just add the callback to the list of notifications 34 * that will be sent upon query completion. 35 */ startNetworkQuery(in INetworkQueryServiceCallback cb)36 void startNetworkQuery(in INetworkQueryServiceCallback cb); 37 38 /** 39 * Tells the service that the requested query is to be ignored. 40 * This may not do anything for the Query request in the 41 * underlying RIL, but it ensures that the callback is removed 42 * from the list of notifications. 43 */ stopNetworkQuery(in INetworkQueryServiceCallback cb)44 void stopNetworkQuery(in INetworkQueryServiceCallback cb); 45 } 46