Skip to content

Struct acq_extra_t

ClassList > acq_extra_t

Per-object extra header for an engine's cross-call state. More...

  • #include <acq_core.h>

Public Attributes

Type Name
uint16_t _pad
uint16_t has_nc
uint64_t n
uint32_t n_noncoh
uint32_t n_unconsumed
uint32_t nc_count
uint64_t samples_consumed

Detailed Description

The state blob is the only thing a fresh engine needs to continue a stream from (descriptor, state, input) — it makes the engine a pure transducer for the elastic fan-out (thread / process / pod). Standard bytes interface (see dp_state.h); layout, contiguous and flat:

[ dp_state_hdr_t ] [ acq_extra_t ] [ float complex unconsumed[n_unconsumed] ] (partial frame, < n samples) [ float nc_surface[n] ] (only when n_noncoh > 1)

Build the byte buffer with acq_state_bytes(); set_state validates the envelope (magic/version/size) plus n / n_noncoh below, rejecting a mismatch rather than reinterpreting it.

Public Attributes Documentation

variable _pad

uint16_t acq_extra_t::_pad;

variable has_nc

uint16_t acq_extra_t::has_nc;

1 if nc_surface[n] follows the samples.


variable n

uint64_t acq_extra_t::n;

Frame size; must equal engine's n.


variable n_noncoh

uint32_t acq_extra_t::n_noncoh;

Non-coherent looks (consistency).


variable n_unconsumed

uint32_t acq_extra_t::n_unconsumed;

Partial-frame samples that follow (< n).


variable nc_count

uint32_t acq_extra_t::nc_count;

Looks accumulated in the current dump.


variable samples_consumed

uint64_t acq_extra_t::samples_consumed;

Stream offset framed so far.



The documentation for this class was generated from the following file native/inc/acq/acq_core.h