1 /*
2  * Copyright (C) 2017 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 #ifndef CHRE_PLATFORM_HOST_LINK_H_
18 #define CHRE_PLATFORM_HOST_LINK_H_
19 
20 #include "chre/target_platform/host_link_base.h"
21 #include "chre/util/non_copyable.h"
22 
23 namespace chre {
24 
25 struct HostMessage;
26 typedef HostMessage MessageToHost;
27 
28 /**
29  * Abstracts the platform-specific communications link between CHRE and the host
30  * processor
31  */
32 class HostLink : public HostLinkBase,
33                  public NonCopyable {
34  public:
35   /**
36    * Enqueues a message for sending to the host. Once sending the message is
37    * complete (success or failure), the platform implementation must invoke
38    * HostCommsManager::onMessageToHostComplete (can be called from any thread).
39    *
40    * @param message A non-null pointer to the message
41    *
42    * @return true if the message was successfully queued
43    */
44   bool sendMessage(const MessageToHost *message);
45 };
46 
47 }  // namespace chre
48 
49 #endif  // CHRE_PLATFORM_HOST_LINK_H_
50