Struct RoundTripLatencyDto 

pub struct RoundTripLatencyDto {
    pub latency_ms: f64,
    pub is_valid: bool,
    pub error: Option<String>,
}

Result of a hardware round-trip latency measurement.

Round-trip latency is the total wall-clock time from when a sample is written to the output ring buffer to when it returns on the input ring buffer after passing through the DAC, the physical audio path, and the ADC. It captures:

• Input and output buffer delays
• Hardware AD/DA conversion time
• OS scheduling and driver latency
• Any resampler buffering in the signal path

The measurement is performed by RoundTripLatencySession on a dedicated thread using private CPAL streams, completely separate from the main audio loopback.

Validity

Always check is_valid before using latency_ms. When is_valid is false the latency_ms field is 0.0 and error contains a human-readable description of what went wrong (e.g. no echo detected, timeout).

Fields

latency_ms: f64

Average round-trip latency in milliseconds across all impulse/echo cycles.

Only meaningful when is_valid is true. Set to 0.0 on failure.

is_valid: bool

Whether the measurement completed successfully.

true when at least IMPULSE_COUNT echoes were detected within the timeout. false when the measurement timed out or the echo signal was undetectable.

error: Option<String>

Human-readable failure reason, or None on success.

Typical messages:

• "Echo not detected above threshold …" — output not routed to input.
• "Round-trip measurement timed out …" — overall deadline exceeded.
• "Round-trip measurement thread panicked" — unexpected internal error.

Implementations

impl RoundTripLatencyDto

pub fn success(latency_ms: f64) -> Self

Creates a successful result with the given averaged latency.

Sets is_valid = true and error = None.

pub fn failure(error: String) -> Self

Creates a failed result with the given error message.

Sets is_valid = false and latency_ms = 0.0.

Trait Implementations

impl Clone for RoundTripLatencyDto

fn clone(&self) -> RoundTripLatencyDto

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RoundTripLatencyDto

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RoundTripLatencyDto

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RoundTripLatencyDto

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.