17d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon/* 27d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * Copyright (C) 2008 The Android Open Source Project 37d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * 47d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * Licensed under the Apache License, Version 2.0 (the "License"); 57d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * you may not use this file except in compliance with the License. 67d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * You may obtain a copy of the License at 77d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * 87d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * http://www.apache.org/licenses/LICENSE-2.0 97d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * 107d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * Unless required by applicable law or agreed to in writing, software 117d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * distributed under the License is distributed on an "AS IS" BASIS, 127d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 137d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * See the License for the specific language governing permissions and 147d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * limitations under the License. 157d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon */ 167d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon 177d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordonpackage com.android.phone; 187d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon 197d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordonimport com.android.phone.INetworkQueryServiceCallback; 207d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon 217d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon/** 227d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * Service interface to handle queries for available networks. The 237d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * Phone application lets this service interface handle carrier 247d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * availability queries instead of making direct calls to the 257d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * GSMPhone layer. 267d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon */ 277d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordononeway interface INetworkQueryService { 287d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon 297d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon /** 307d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * Starts a network query if it has not been started yet, and 317d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * request a callback through the INetworkQueryServiceCallback 327d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * object on query completion. If there is an existing request, 337d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * then just add the callback to the list of notifications 347d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * that will be sent upon query completion. 357d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon */ 367d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon void startNetworkQuery(in INetworkQueryServiceCallback cb); 377d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon 387d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon /** 397d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * Tells the service that the requested query is to be ignored. 407d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * This may not do anything for the Query request in the 417d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * underlying RIL, but it ensures that the callback is removed 427d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon * from the list of notifications. 437d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon */ 447d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon void stopNetworkQuery(in INetworkQueryServiceCallback cb); 457d4ddf6dc0d7c8158bac3a5dec7936e837e95bddSantos Cordon} 46