Merge "libgui: Add generation numbers to BufferQueue" into mnc-dev

    // buffer as the number of frames that have elapsed since it was last queued

    uint64_t mBufferAge;

    // mGenerationNumber stores the current generation number of the attached

    // producer. Any attempt to attach a buffer with a different generation

    // number will fail.

    uint32_t mGenerationNumber;

}; // class BufferQueueCore

} // namespace android

    // See IGraphicBufferProducer::allowAllocation

    virtual status_t allowAllocation(bool allow);

    // See IGraphicBufferProducer::setGenerationNumber

    virtual status_t setGenerationNumber(uint32_t generationNumber);

private:

    // This is required by the IBinder::DeathRecipient interface

    virtual void binderDied(const wp<IBinder>& who);

    // will be deallocated as stale.

    //

    // Return of a value other than NO_ERROR means an error has occurred:

    // * BAD_VALUE - outSlot or buffer were NULL

    // * BAD_VALUE - outSlot or buffer were NULL, or the generation number of

    //               the buffer did not match the buffer queue.

    // * INVALID_OPERATION - cannot attach the buffer because it would cause too

    //                       many buffers to be acquired.

    // * NO_MEMORY - no free slots available

    //

    // Return of a negative value means an error has occurred:

    // * NO_INIT - the buffer queue has been abandoned.

    // * BAD_VALUE - outSlot or buffer were NULL or invalid combination of

    //               async mode and buffer count override.

    // * BAD_VALUE - outSlot or buffer were NULL, invalid combination of

    //               async mode and buffer count override, or the generation

    //               number of the buffer did not match the buffer queue.

    // * INVALID_OPERATION - cannot attach the buffer because it would cause

    //                       too many buffers to be dequeued, either because

    //                       the producer already has a single buffer dequeued

    // eligible slot is available, dequeueBuffer will block or return an error

    // as usual.

    virtual status_t allowAllocation(bool allow) = 0;

    // Sets the current generation number of the BufferQueue.

    //

    // This generation number will be inserted into any buffers allocated by the

    // BufferQueue, and any attempts to attach a buffer with a different

    // generation number will fail. Buffers already in the queue are not

    // affected and will retain their current generation number. The generation

    // number defaults to 0.

    virtual status_t setGenerationNumber(uint32_t generationNumber) = 0;

};

// ----------------------------------------------------------------------------

     */

    void allocateBuffers();

    /* Sets the generation number on the IGraphicBufferProducer and updates the

     * generation number on any buffers attached to the Surface after this call.

     * See IGBP::setGenerationNumber for more information. */

    status_t setGenerationNumber(uint32_t generationNumber);

protected:

    virtual ~Surface();

    // When a non-CPU producer is attached, this reflects the surface damage

    // (the change since the previous frame) passed in by the producer.

    Region mDirtyRegion;

    // Stores the current generation number. See setGenerationNumber and

    // IGraphicBufferProducer::setGenerationNumber for more information.

    uint32_t mGenerationNumber;

};

}; // namespace android