copy_region

Description:

public Buffer copy_region (BufferCopyFlags flags, size_t offset, size_t size)

Creates a sub-buffer from this at offset and size.

This sub-buffer uses the actual memory space of the parent buffer. This function will copy the offset and timestamp fields when the offset is 0. If not, they will be set to CLOCK_TIME_NONE and BUFFER_OFFSET_NONE. If offset equals 0 and size equals the total size of buffer, the duration and offset end fields are also copied. If not they will be set to CLOCK_TIME_NONE and BUFFER_OFFSET_NONE.

Parameters:

this	a Buffer.
flags	the BufferCopyFlags
offset	the offset into parent Buffer at which the new sub-buffer begins.
size	the size of the new Buffer sub-buffer, in bytes. If -1, all data is copied.

Returns:

the new Buffer or null if the arguments were invalid.