OLD | NEW |
1 /* | 1 /* |
2 * Copyright 2015 The WebRTC Project Authors. All rights reserved. | 2 * Copyright 2015 The WebRTC Project Authors. All rights reserved. |
3 * | 3 * |
4 * Use of this source code is governed by a BSD-style license | 4 * Use of this source code is governed by a BSD-style license |
5 * that can be found in the LICENSE file in the root of the source | 5 * that can be found in the LICENSE file in the root of the source |
6 * tree. An additional intellectual property rights grant can be found | 6 * tree. An additional intellectual property rights grant can be found |
7 * in the file PATENTS. All contributing project authors may | 7 * in the file PATENTS. All contributing project authors may |
8 * be found in the AUTHORS file in the root of the source tree. | 8 * be found in the AUTHORS file in the root of the source tree. |
9 */ | 9 */ |
10 | 10 |
11 #ifndef WEBRTC_BASE_BUFFERQUEUE_H_ | 11 #ifndef WEBRTC_BASE_BUFFERQUEUE_H_ |
12 #define WEBRTC_BASE_BUFFERQUEUE_H_ | 12 #define WEBRTC_BASE_BUFFERQUEUE_H_ |
13 | 13 |
14 #include <deque> | 14 #include <deque> |
15 #include <vector> | 15 #include <vector> |
16 | 16 |
17 #include "webrtc/base/buffer.h" | 17 #include "webrtc/base/buffer.h" |
18 #include "webrtc/base/criticalsection.h" | 18 #include "webrtc/base/criticalsection.h" |
19 | 19 |
20 namespace rtc { | 20 namespace rtc { |
21 | 21 |
22 class BufferQueue { | 22 class BufferQueue { |
23 public: | 23 public: |
24 // Creates a buffer queue queue with a given capacity and default buffer size. | 24 // Creates a buffer queue with a given capacity and default buffer size. |
25 BufferQueue(size_t capacity, size_t default_size); | 25 BufferQueue(size_t capacity, size_t default_size); |
26 ~BufferQueue(); | 26 virtual ~BufferQueue(); |
27 | 27 |
28 // Return number of queued buffers. | 28 // Return number of queued buffers. |
29 size_t size() const; | 29 size_t size() const; |
30 | 30 |
31 // ReadFront will only read one buffer at a time and will truncate buffers | 31 // ReadFront will only read one buffer at a time and will truncate buffers |
32 // that don't fit in the passed memory. | 32 // that don't fit in the passed memory. |
| 33 // Returns true unless no data could be returned. |
33 bool ReadFront(void* data, size_t bytes, size_t* bytes_read); | 34 bool ReadFront(void* data, size_t bytes, size_t* bytes_read); |
34 | 35 |
35 // WriteBack always writes either the complete memory or nothing. | 36 // WriteBack always writes either the complete memory or nothing. |
| 37 // Returns true unless no data could be written. |
36 bool WriteBack(const void* data, size_t bytes, size_t* bytes_written); | 38 bool WriteBack(const void* data, size_t bytes, size_t* bytes_written); |
37 | 39 |
| 40 protected: |
| 41 // These methods are called when the state of the queue changes. |
| 42 virtual void NotifyReadableForTest() {} |
| 43 virtual void NotifyWritableForTest() {} |
| 44 |
38 private: | 45 private: |
39 size_t capacity_; | 46 size_t capacity_; |
40 size_t default_size_; | 47 size_t default_size_; |
41 std::deque<Buffer*> queue_; | 48 mutable CriticalSection crit_; |
42 std::vector<Buffer*> free_list_; | 49 std::deque<Buffer*> queue_ GUARDED_BY(crit_); |
43 mutable CriticalSection crit_; // object lock | 50 std::vector<Buffer*> free_list_ GUARDED_BY(crit_); |
44 | 51 |
45 RTC_DISALLOW_COPY_AND_ASSIGN(BufferQueue); | 52 RTC_DISALLOW_COPY_AND_ASSIGN(BufferQueue); |
46 }; | 53 }; |
47 | 54 |
48 } // namespace rtc | 55 } // namespace rtc |
49 | 56 |
50 #endif // WEBRTC_BASE_BUFFERQUEUE_H_ | 57 #endif // WEBRTC_BASE_BUFFERQUEUE_H_ |
OLD | NEW |