Struct Instance 

pub struct Instance {
    pub info: InstanceInfo,
    pub surface_ext: bool,
    /* private fields */
}

There is no global state in Vulkan and all per-application state is stored in a VkInstance object.

Creating an Instance initializes the Vulkan library and allows the application to pass information about itself to the implementation.

Fields

info: InstanceInfo

Information used to create this resource.

Note: This field is read-only.

surface_ext: bool

True if VK_KHR_surface is enabled on this instance.

Note: This field is read-only.

Implementations

impl Instance

pub const LATEST_API_VERSION: ApiVersion = ApiVersion::Vulkan13

The most recent supported version of Vulkan.

pub fn create(info: impl Into<InstanceInfo>) -> Result<Self, DriverError>

Creates a new Vulkan instance.

This constructor is intended for headless or manually managed setups. It does not infer or enable display platform surface extensions. Use Self::try_from_display when the resulting instance must be capable of later surface creation.

pub fn entry(this: &Self) -> &Entry

The ash entrypoint used to load Vulkan instance functions.

pub fn physical_device( this: &Self, physical_device: PhysicalDevice, ) -> Result<PhysicalDevice, DriverError>

Returns a wrapper structure for a physical device of this instance.

pub fn physical_devices( this: &Self, ) -> Result<impl IntoIterator<Item = PhysicalDevice>, DriverError>

Returns the available physical devices of this instance.

pub fn try_from_display( display: impl HasDisplayHandle, info: impl Into<InstanceInfo>, ) -> Result<Self, DriverError>

Creates a new Vulkan instance with the platform surface extensions required by the provided display handle.

pub fn try_from_entry( entry: Entry, instance: Instance, ) -> Result<Self, DriverError>

Loads an existing Vulkan instance that may have been created by other means.

This is useful when you want to use a Vulkan instance created by some other library, such as OpenXR.

Trait Implementations

impl Clone for Instance

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 Instance

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

Formats the value using the given formatter.