Struct HardwareEncodeInput 

pub struct HardwareEncodeInput { /* private fields */ }

The coordinator’s half of a hardware session.

Implementations

impl HardwareEncodeInput

pub fn acquire_surface(&mut self) -> Result<EncoderSurface, EncodeError>

Takes one surface from the session’s pool.

The pool allocates on demand, so its size is the peak outstanding; the caller bounds that.

Errors

Returns an adapter failure when the pool cannot allocate.

pub fn begin_frame( &mut self, surface: &EncoderSurface, ) -> Result<InputFrame, EncodeError>

Begins a frame bound for surface, waiting until its planes are free. Call it before recording the pack render into Self::planes, and submit that render before Self::submit.

Errors

Returns an error for a surface from another pool, or when the wait fails.

pub fn planes(&self, frame: &InputFrame) -> (&Texture, &Texture)

The luma and interleaved chroma textures frame is packed into.

pub fn submit( &mut self, frame: InputFrame, surface: &mut EncoderSurface, ) -> Result<(), EncodeError>

Moves frame’s packed planes into surface on the GPU; the encoder waits for it on the GPU.

Errors

Returns an error for a surface from another pool, or when the handoff cannot be submitted.

pub fn set_time(&self, surface: &mut EncoderSurface, time: MediaTime)

Stamps surface with its presentation time.

pub fn stats(&self) -> EncoderPoolStats

This session’s pool counters so far.

pub fn finish(self) -> Result<(), EncodeError>

Waits for every in-flight handoff and releases the input resources.

Errors

On timeout or device loss, resources the GPU may still use are kept rather than freed.