Struct FrameCtx 

#[non_exhaustive]
pub struct FrameCtx<'a> {
    pub session_id: SessionId,
    pub side: ProxySide,
    pub draft: DraftVersion,
    pub stream_id: Option<u64>,
    pub arrived_at: Instant,
    pub caps: &'a Capabilities,
}

Context for a control message or datagram decision.

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.

session_id: SessionId

The session identifier.

side: ProxySide

The side the unit arrived on.

draft: DraftVersion

The draft this unit was parsed under.

A session’s draft is not necessarily the one it was configured with. The ALPN names a draft outright from draft-15 on, and such a session is settled before it dials, so this never moves. Drafts 07 to 14 share the one ALPN moq-00: a session in that cohort starts on the draft its configuration named and the control stream refines it from the first SETUP it can read — CLIENT_SETUP’s highest offered version, which SERVER_SETUP’s selected version then outranks, because the second is what the peers agreed and the first is only what one of them proposed.

Both sites this context is built for see the refined answer rather than the starting draft, by two different mechanisms. ProxyHook::on_datagram’s forwarding task waits for the control stream to answer before it reads its first datagram. ProxyHook::on_control_message needs no wait: a session that declared Interest::CONTROL withholds the control stream’s bytes until the leading SETUP has been peeked at, so even the frame that named the draft is reported under it.

Two cases end the wait with the starting draft instead, and both are sessions no draft describes: a peer that sends no SETUP at all, and a peer whose first control message is something else. A SETUP arriving after either still refines what comes after it.

stream_id: Option<u64>

The stream this frame belongs to. None for datagrams.

arrived_at: Instant

When the proxy produced this unit for decision.

caps: &'a Capabilities

What is executable on this draft at this site.

Implementations

impl<'a> FrameCtx<'a>

pub fn new( session_id: SessionId, side: ProxySide, draft: DraftVersion, stream_id: Option<u64>, arrived_at: Instant, caps: &'a Capabilities, ) -> Self

Build a context. Field order matches the struct.

stream_id is None for datagrams.

Trait Implementations

impl<'a> Clone for FrameCtx<'a>

fn clone(&self) -> FrameCtx<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for FrameCtx<'a>

impl<'a> Debug for FrameCtx<'a>

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

Formats the value using the given formatter.