Struct PooledBuffer 

pub struct PooledBuffer { /* private fields */ }

A buffer acquired from a FramePool.

When this buffer is dropped, it is automatically returned to its parent pool if the pool still exists. This enables zero-overhead buffer reuse during video decoding.

Memory Management

The buffer holds a weak reference to its parent pool. If the pool is dropped before the buffer, the buffer’s memory is simply freed rather than being returned to the pool.

Cloning

When cloned, the new buffer becomes a standalone buffer (no pool reference). This prevents double-free issues where both the original and cloned buffer would attempt to return the same memory to the pool.

Implementations

impl PooledBuffer

pub fn new(data: Vec<u8>, pool: Weak<dyn FramePool>) -> Self

Creates a new pooled buffer with a reference to its parent pool.

Arguments

• data - The buffer data.
• pool - A weak reference to the parent pool.

pub fn standalone(data: Vec<u8>) -> Self

Creates a new pooled buffer without a parent pool.

This is useful for buffers allocated outside of a pool context. When dropped, the buffer’s memory is simply freed.

pub fn data(&self) -> &[u8]

Returns a reference to the buffer data.

pub fn data_mut(&mut self) -> &mut [u8]

Returns a mutable reference to the buffer data.

pub fn len(&self) -> usize

Returns the length of the buffer in bytes.

pub fn is_empty(&self) -> bool

Returns true if the buffer is empty.

pub fn into_inner(self) -> Vec<u8>

Consumes the buffer and returns the underlying data.

After calling this, the buffer will not be returned to the pool.

Trait Implementations

impl AsMut<[u8]> for PooledBuffer

fn as_mut(&mut self) -> &mut [u8]

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<[u8]> for PooledBuffer

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for PooledBuffer

fn clone(&self) -> Self

Clones the buffer data, but the cloned buffer becomes standalone.

The cloned buffer will NOT be returned to the pool when dropped. This prevents double-free issues where both buffers would attempt to return the same memory to the pool.

Only the original buffer retains its pool reference.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PooledBuffer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for PooledBuffer

fn drop(&mut self)

Executes the destructor for this type.