Struct AppliedPriority 

pub struct AppliedPriority { /* private fields */ }

What a thread-priority request actually produced.

Returned by set_thread_priority and promote_thread_to_realtime in place of (). The unit return was a lie by omission: on Linux a “successful” set_thread_priority(Highest) can mean you got Highest, or that every privileged path was denied and you silently kept the level you already had (Normal for a fresh thread). This says which - uniformly across platforms, so callers never #[cfg].

Branch on Grant / AppliedPriority::degraded / AppliedPriority::reason / AppliedPriority::mechanism for logic; use the Display impl for the human-readable form.

Implementations

impl AppliedPriority

pub fn from_parts( requested: ThreadPriority, effective: ThreadPriority, grant: Grant, reason: Option<FallbackReason>, mechanism: Mechanism, broker_error: Option<BrokerError>, ) -> Option<Self>

Rebuilds an outcome from structured data.

Returns None when the parts contradict each other, such as a broker error without a broker-refused reason.

pub fn requested(&self) -> ThreadPriority

The level the caller requested.

pub fn effective(&self) -> ThreadPriority

The level actually in effect.

pub fn grant(&self) -> Grant

How the request was satisfied.

pub fn reason(&self) -> Option<FallbackReason>

Why the request fell short, if it did.

pub fn mechanism(&self) -> Mechanism

The concrete OS scheduling mechanism the request landed on.

pub fn broker_error(&self) -> Option<BrokerError>

The typed reason a broker refused the grant.

pub fn degraded(&self) -> bool

true when the request did NOT get a clean grant of exactly what was asked - a fall back to a weaker level (Highest -> Normal) or a broker clamp within the level (TimeCritical -> nice -15). Equivalent to reason.is_some(); the FallbackReason says which.

Trait Implementations

impl Clone for AppliedPriority

fn clone(&self) -> AppliedPriority

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AppliedPriority

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

Formats the value using the given formatter.

impl Display for AppliedPriority

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

Formats the value using the given formatter.

impl Eq for AppliedPriority

impl PartialEq for AppliedPriority

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for AppliedPriority