Struct VaapiSurface 

pub struct VaapiSurface { /* private fields */ }

Available on Linux only.

VAAPI surface (VASurfaceID + VADisplay). Kept as a newtype so the GpuResource enum can carry it uniformly with the rest.

Implementations

impl VaapiSurface

pub unsafe fn try_from_raw( surface: u32, display: *mut c_void, keep_alive: Option<KeepAlive>, ) -> Result<Self, InvalidHandleError>

Wrap a VASurfaceID together with its VADisplay. Borrowing: the handle is stored non-owningly, this type has no Drop, and every obligation below extends to each Clone.

Safety

• display must be a live VADisplay on which vaInitialize succeeded and vaTerminate has not run. Null is rejected as InvalidHandleError::NullPointer and is not a caller obligation.
• surface must be a VASurfaceID currently allocated on that display. It is a plain u32 index, so nothing distinguishes a stale or fabricated id from a live one — including 0, which is deliberately not rejected here because 0 is a legal VASurfaceID. Passing a destroyed surface makes the exporter’s vaExportSurfaceHandle address a recycled slot.
• Lifetime: nothing is retained and there is no Drop. Neither vaDestroySurfaces nor vaTerminate may run while this value or any Clone of it is reachable, and the surface must not be recycled back into the decoder’s pool either — a reused id silently yields another frame’s pixels. keep_alive exists to anchor the decoder context that owns both; with None the caller carries the obligation.
• Thread affinity: VaapiSurface is Send + Sync, but libva serialises on a per-VADisplay lock and most drivers require that a surface not be exported while the decoder is still writing it. The caller must have completed vaSyncSurface (or an equivalent fence) before handing the id over.

pub fn surface(&self) -> u32

pub fn display(&self) -> *mut c_void

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

Trait Implementations

impl Clone for VaapiSurface

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 VaapiSurface

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

Formats the value using the given formatter.

impl Send for VaapiSurface

impl Sync for VaapiSurface