sc_mining_v1.request

enabled is exactly 0 or 1. Accept or remove owner-scoped intent; repeated requests are idempotent. OK accepts intent even when engine/admission/hook is unavailable; read state to distinguish active. Disable also removes intent after a fault latch.

Signature

sco_result (*)(sco_plugin *, uint32_t)

Service and availability

Service index

Property	Value
Symbol	`sc_mining_v1.request`
Record ID	`sc-mining-v1-request`
Service	game.mining
Table	sc_mining_v1
Version macro	SC_MINING_SERVICE_VERSION
Packed table version	65536
Since / availability	`size >= 16`; 1.0
Complete member extent (x64 bytes)	16
Table size (x64 bytes)	24

Header source

Parameters and buffers

sco_result (*request)(sco_plugin* self, uint32_t enabled);
enabled is exactly 0 or 1. Accept or remove owner-scoped intent; repeated requests are idempotent. OK accepts intent even when engine/admission/hook is unavailable; read state to distinguish active. Disable also removes intent after a fault latch.

Results and failures

OK accepted intent, not engine acceptance; BAD_ARG invalid/released self or enabled; WRONG_THREAD; UNAVAILABLE stopped/runtime-stopping or reentrant call; FAILED full 64-owner registry.

Absent capability

game.mining remains false by default. Accepted request intent does not imply an available or active engine adapter.

Ownership

Up to 64 live owners retain independent intent; worker sees only aggregate count. Caller owns copied output; no native pointer or allocation transfer.

Thread affinity

Game thread only; WRONG_THREAD before owner/state access. Worker promotion never calls plugins.

Callback context

No plugin callback; worker invokes host-owned process-retained backend only.

Reentrancy

Public calls during backend admission/install are refused with UNAVAILABLE.

Cleanup and cancellation

Disable/unload removes only that owner intent. Stop clears all intent and withdraws the service; detour, trampoline and callbacks remain process-retained in pass-through mode. Fault latch requires restart.

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/sc_mining.h `(*request)`
cpp	direct	include/sc_mining.h `(*request)`
csharp	unsupported	docs/contracts.md `C# and Lua game.mining routes are unsupported.`
lua	unsupported	docs/contracts.md `C# and Lua game.mining routes are unsupported.`

Examples

None identified in the catalogue; this is not proof none can exist.

Tests

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