Struct DeviceDescription 

#[non_exhaustive]
pub struct DeviceDescription {
    pub name: String,
    pub kind: DeviceKind,
    pub max_memory: Option<u64>,
    pub physical: Option<PhysicalDevice>,
    pub architecture: Option<String>,
    pub driver_version: Option<String>,
}

Identity and properties of a device, as its driver reports before anything runs on it: enough to list the machine’s devices, show them to a user and pick one.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

name: String

The name the device reports, e.g. NVIDIA GeForce RTX 5070 Laptop GPU.

kind: DeviceKind

The kind of device.

max_memory: Option<u64>

The memory the device can use, in bytes. The card’s own memory for a GPU, the machine’s RAM for the CPU runtime, and on Metal the working set the device recommends staying under. None where the runtime’s API does not say.

physical: Option<PhysicalDevice>

The card the device runs on. None for a device that is not a card: a CPU or a software rasterizer.

architecture: Option<String>

The architecture the runtime compiles for: the NVPTX target on CUDA, the gcnArchName on HIP, the LLVM CPU name on the CPU runtime. None on Metal and wgpu.

driver_version: Option<String>

The driver’s version, in each API’s own terms, so two runtimes on one card can disagree: on CUDA the CUDA version the driver supports (13.0), on HIP the HIP version (7.1.25424), on wgpu the driver’s name and release (NVIDIA 580.82.09). None on Metal and the CPU runtime.

Implementations

impl DeviceDescription

pub fn new(name: impl Into<String>, kind: DeviceKind) -> Self

A device named name, of kind.

Trait Implementations

impl Clone for DeviceDescription

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 DeviceDescription

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

Formats the value using the given formatter.

impl Eq for DeviceDescription

impl PartialEq for DeviceDescription

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for DeviceDescription