Struct Instance

pub struct Instance {
    pub name: String,
    pub instance_per_backend: Vec<(Backend, Box<dyn DynInstance>)>,
    pub flags: InstanceFlags,
}

Available on crate feature unstable-wgpu-24 only.

Fields

name: String

instance_per_backend: Vec<(Backend, Box<dyn DynInstance>)>

List of instances per backend.

The ordering in this list implies prioritization and needs to be preserved.

flags: InstanceFlags

Implementations

impl Instance

pub fn new(name: &str, instance_desc: &InstanceDescriptor) -> Instance

pub fn raw(&self, backend: Backend) -> Option<&(dyn DynInstance + 'static)>

pub unsafe fn as_hal<A>(&self) -> Option<&<A as Api>::Instance>

where A: HalApi,

Safety

• The raw instance handle returned must not be manually destroyed.

pub unsafe fn create_surface( &self, display_handle: RawDisplayHandle, window_handle: RawWindowHandle, ) -> Result<Surface, CreateSurfaceError>

Creates a new surface targeting the given display/window handles.

Internally attempts to create hal surfaces for all enabled backends.

Fails only if creation for surfaces for all enabled backends fails in which case the error for each enabled backend is listed. Vice versa, if creation for any backend succeeds, success is returned. Surface creation errors are logged to the debug log in any case.

Safety

• display_handle must be a valid object to create a surface upon.
• window_handle must remain valid as long as the returned SurfaceId is being used.

pub fn enumerate_adapters(&self, backends: Backends) -> Vec<Adapter>

pub fn request_adapter( &self, desc: &RequestAdapterOptions<&Surface>, backends: Backends, ) -> Result<Adapter, RequestAdapterError>

Trait Implementations

impl Default for Instance

fn default() -> Instance

Returns the “default value” for a type.