Table of Contents

Interface IMemoryMappingSource

Namespace
CStructSharp.Memory
Assembly
CStructSharp.dll

Optional demand-driven logical-to-backing provenance for a source, including dynamic translations.

public interface IMemoryMappingSource : IMemorySource
Inherited Members

Remarks

Source objects distinguish address spaces; Id is diagnostic only. Generation and source stability remain caller contracts. This capability describes read provenance, without promising reverse mapping, atomic snapshots or writable dynamic mappings.

Methods

Describe(ulong, int, MemoryAccessContext?)

Describes a fully mapped finite range in logical byte order, without reading payload bytes.

IReadOnlyList<MemoryRegion> Describe(ulong address, int length, MemoryAccessContext? context = null)

Parameters

address ulong

First logical byte in this source.

length int

Finite byte count; a final byte at ulong.MaxValue is allowed.

context MemoryAccessContext

Shared cancellation and mapping budget, or a new default operation.

Returns

IReadOnlyList<MemoryRegion>

Positive-length backing fragments covering exactly the requested count; an empty list for zero length.

Exceptions

MemoryAccessException

A mapping is absent or work limits are exhausted.

OperationCanceledException

Cancellation was requested.

Edit this page