Struct VulkanEncodeFrameAccess 

pub struct VulkanEncodeFrameAccess<'a> { /* private fields */ }

One encoder-pool frame held open for a native GPU write.

The decode path reaches its frames through a VulkanFrameLease, which owns the AVFrame behind a mutex because several decode threads share it. An encoder-input frame has one owner (the export that took it from the pool), so it is borrowed directly, and this guard exists only to pair frame_access_begin with its end.

It stays on the thread that began it: begin takes FFmpeg’s frame mutex and the bridge’s queue mutex, which only the thread holding them can release.

Implementations

impl<'a> VulkanEncodeFrameAccess<'a>

pub fn retain_frame(&self) -> Result<AVFrame, BridgeError>

Retains the frame’s buffers and hardware pool beyond this access guard.

Errors

Returns an allocation error if FFmpeg cannot create the reference.

pub fn begin(frame: &'a mut AVFrame) -> Result<Self, BridgeError>

Opens one handoff on an encoder-pool frame.

Errors

Returns an error when the frame is not a usable Vulkan frame.

pub const fn access(&self) -> &VulkanFrameAccess

The frame’s state while its FFmpeg locks are held.

pub const unsafe fn access_mut(&mut self) -> &mut VulkanFrameAccess

The record written back to the frame on Self::commit, for a submission to update; checked as VulkanFrameAccessGuard::access_mut says.

Safety

As for VulkanFrameAccessGuard::access_mut.

pub fn commit(&mut self)

Writes the updated layout and timeline values back when released.

Trait Implementations

impl Drop for VulkanEncodeFrameAccess<'_>

Available on Linux and crate feature hwdevice only.

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.