Struct CpuBytes 

pub struct CpuBytes { /* private fields */ }

Flat CPU byte buffer. The raw ptr is non-owning; keep_alive pins whatever owns the backing allocation (an SDK decoder’s frame anchor, an aligned-buffer pool slot, a boxed expand buffer, …) so the bytes outlive every clone the caller hands off. Pass None only when the caller guarantees the allocation’s lifetime by other means (e.g. a test stack buffer that outlives the handle).

Implementations

impl CpuBytes

pub unsafe fn try_from_raw( ptr: *mut u8, size: usize, row_pitch: u32, format: PixelFormat, keep_alive: Option<KeepAlive>, ) -> Result<Self, InvalidHandleError>

Wrap a flat CPU byte buffer. Borrowing: the handle is stored non-owningly, this type has no Drop, and every obligation below extends to each Clone.

Safety

• ptr must point to size bytes that are valid to read and write — upload paths read the whole range, readback paths write it. Both ptr == null and size == 0 are rejected (InvalidHandleError::NullPointer / InvalidHandleError::ZeroSize) and are therefore not caller obligations; nothing else about the range is checkable here.
• row_pitch must be the real row stride in bytes and format the real layout, such that row_pitch * <rows implied by format and the consumer's extent> fits inside size. Consumers index rows by row_pitch, so an over-stated pitch or format walks off the end of the allocation.
• Aliasing. The pointer is stored as *mut u8 and handed to consumers that may write through it, while Clone hands out further copies. For the duration of this value and every clone the caller must not hold a &/&mut Rust reference to the same bytes, and must not let two consumers write the same range concurrently — CpuBytes provides no synchronisation of its own even though it is Send + Sync.
• Lifetime. Nothing is retained and there is no Drop: the backing allocation is neither freed nor kept alive here. It must outlive this value and every clone, pinned either by the keep_alive anchor (an SDK decoder’s frame anchor, an aligned-buffer pool slot, a boxed expand buffer) or, when keep_alive is None, by the caller directly. A pool slot recycled while a clone survives is a use-after-free.

pub fn ptr(&self) -> *mut u8

pub fn size(&self) -> usize

pub fn row_pitch(&self) -> u32

pub fn format(&self) -> PixelFormat

pub fn keep_alive(&self) -> Option<&KeepAlive>

Trait Implementations

impl Clone for CpuBytes

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CpuBytes

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

Formats the value using the given formatter.

impl Send for CpuBytes

impl Sync for CpuBytes