sco_diagnostics_publisher_v1.submit

Copies a size-prefixed 8-byte observation; no pointers retained, output, text, identifiers or arbitrary fields.

Signature

sco_result (*)(sco_plugin *, const sco_diagnostics_observation_v1 *)

Service and availability

Service index

Property	Value
Symbol	`sco_diagnostics_publisher_v1.submit`
Record ID	`sco-diagnostics-publisher-v1-submit`
Service	sco.diagnostics.publisher
Table	sco_diagnostics_publisher_v1
Version macro	SCO_DIAGNOSTICS_PUBLISHER_VERSION_1_0
Packed table version	65536
Since / availability	`size >= 16`; 1.0
Complete member extent (x64 bytes)	16
Table size (x64 bytes)	16

Header source

Parameters and buffers

sco_result (*submit)(sco_plugin* self, const sco_diagnostics_observation_v1* observation);
Copies a size-prefixed 8-byte observation; no pointers retained, output, text, identifiers or arbitrary fields.

Results and failures

Query NOT_FOUND when default-off/absent; BAD_ARG invalid/released/unselected owner or null/short/unknown record; WRONG_THREAD off game thread; UNAVAILABLE stopped/terminal shutdown; TOO_MANY excess rate or allocation failure.

Absent capability

Requires explicit trusted host source opt-in, selected plugin ID and positive offline admission; grants no endpoint admission.

Ownership

Host-owned source buffer; selected live plugin only. Advisory health never establishes host/game readiness or faults.

Thread affinity

Game thread only; synchronous memory copy, no callbacks or transport.

Callback context

No callbacks.

Reentrancy

Callable from normal game-thread plugin callbacks; never called by capture or endpoint demand.

Cleanup and cancellation

Host Stop clears ingress before shutdown callouts. Release/quarantine suppresses source; new owner starts empty. Borrowed table is process-lifetime; service reopen clears records.

Language mappings

Status labels are copied verbatim from the catalogue: direct is native access; typed-wrapper is wrapper-backed; restricted is a subset/adaptation; unsupported means no supported route is established. No status implies universal safety.

Language	Catalogue status	Source evidence / wrapper tokens
c	direct	include/sco_diagnostics_publisher.h `(*submit)`
cpp	typed-wrapper	include/scosdk/diagnostics_publisher.hpp `table_->submit(`
csharp	unsupported	docs/design/diagnostics-publishers.md `no C#/Lua binding`
lua	unsupported	docs/design/diagnostics-publishers.md `no C#/Lua binding`

Examples

sdk/examples/diagnostics_publisher/diagnostics_publisher.c

Tests

ABI pins prove layout, not semantic behavior or a live game session.