1/* 2 * Copyright 2014 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 ANDROID_GUI_IPRODUCERLISTENER_H 18#define ANDROID_GUI_IPRODUCERLISTENER_H 19 20#include <binder/IInterface.h> 21 22#include <utils/RefBase.h> 23 24namespace android { 25 26// ProducerListener is the interface through which the BufferQueue notifies the 27// producer of events that the producer may wish to react to. Because the 28// producer will generally have a mutex that is locked during calls from the 29// producer to the BufferQueue, these calls from the BufferQueue to the 30// producer *MUST* be called only when the BufferQueue mutex is NOT locked. 31 32class ProducerListener : public virtual RefBase 33{ 34public: 35 ProducerListener() {} 36 virtual ~ProducerListener(); 37 38 // onBufferReleased is called from IGraphicBufferConsumer::releaseBuffer to 39 // notify the producer that a new buffer is free and ready to be dequeued. 40 // 41 // This is called without any lock held and can be called concurrently by 42 // multiple threads. 43 virtual void onBufferReleased() = 0; // Asynchronous 44 virtual bool needsReleaseNotify() = 0; 45}; 46 47class IProducerListener : public ProducerListener, public IInterface 48{ 49public: 50 DECLARE_META_INTERFACE(ProducerListener) 51}; 52 53class BnProducerListener : public BnInterface<IProducerListener> 54{ 55public: 56 virtual status_t onTransact(uint32_t code, const Parcel& data, 57 Parcel* reply, uint32_t flags = 0); 58 virtual bool needsReleaseNotify(); 59}; 60 61class DummyProducerListener : public BnProducerListener 62{ 63public: 64 virtual ~DummyProducerListener(); 65 virtual void onBufferReleased() {} 66 virtual bool needsReleaseNotify() { return false; } 67}; 68 69} // namespace android 70 71#endif 72