Struct MemoryAdviseState 

pub struct MemoryAdviseState { /* private fields */ }

Accumulates memory-advise hints for a single USM range.

Applying a set hint records it; applying the matching clear hint removes it. BiasCached / BiasUncached are mutually exclusive — the most recent wins. This lets a planner fold a sequence of advise calls into the minimal effective set before touching the driver.

Implementations

impl MemoryAdviseState

pub fn new() -> Self

A fresh state with no advice applied.

pub fn apply(&mut self, advice: MemoryAdvice)

Apply one advice hint, folding it into the effective state.

pub fn is_read_mostly(&self) -> bool

true when SetReadMostly is currently in effect.

pub fn is_preferred_location(&self) -> bool

true when the range is pinned to its preferred device location.

pub fn is_accessed_by_device(&self) -> bool

true when the device is marked as an accessor of this range.

pub fn cache_bias(&self) -> Option<bool>

The cache bias: Some(true) cached, Some(false) uncached, None driver-default.

pub fn effective_advice(&self) -> Vec<MemoryAdvice>

The minimal sequence of advise calls that reproduces this state from a freshly-allocated range. Used to replay folded hints to the driver.

Trait Implementations

impl Clone for MemoryAdviseState

fn clone(&self) -> MemoryAdviseState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MemoryAdviseState

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

Formats the value using the given formatter.

impl Default for MemoryAdviseState

fn default() -> MemoryAdviseState

Returns the “default value” for a type.