NativeGuiResourceManager

A device-owned GUI cache lifetime participant registered with one NativeCanvasDevice.

Implementations own independently budgeted native resources while borrowing the device's ordered fence, finish, and destruction-drain lifecycle. Every callback runs on the device construction thread, callbacks never reenter the device, and registration transfers terminal cleanup responsibility to the device. Implementations must keep ordinary callbacks nonblocking and may call the device driver's nonblocking fence operation through their constructor-owned driver.

This SPI is internal to Strata's versioned adapters and is not a component or application extension point.

Functions

Link copied to clipboard
abstract fun acknowledgeAfterDrain()

Requires physical destruction after the device has drained deferred native releases.

Link copied to clipboard
abstract fun beginShutdown()

Stops acquisition and drops unconsumed GUI pins before the device submits as required and completes recorded work during terminal shutdown.

Link copied to clipboard
abstract fun closeAfterFinish()

Closes every owned resource after recorded work has been submitted as required and completed, before deferred destruction is drained.

Link copied to clipboard
abstract fun consumed()

Settles native resources referenced by GUI work that the version adapter has successfully consumed.

Link copied to clipboard
abstract fun failedGui()

Quarantines resources whose queued GUI work failed before complete submission through complete GUI consumption could be established.

Link copied to clipboard
abstract fun poll()

Polls completion and physical destruction without waiting or issuing unconsumed GUI work.

Link copied to clipboard
abstract fun reload()

Invalidates every active derived cache entry after a native resource reload.

Link copied to clipboard
abstract fun retainedResourceBytes(): Long

Reports active and retired native payload bytes without polling or allocating.

Link copied to clipboard
abstract fun retainedResourceCount(): Int

Reports active and retired native entry reservations without polling or allocating.