ryujinx-mirror/Ryujinx.Memory/IVirtualMemoryManager.cs

using System;

namespace Ryujinx.Memory
{
    public interface IVirtualMemoryManager
    {
        void Map(ulong va, ulong pa, ulong size);
        void Unmap(ulong va, ulong size);

        T Read<T>(ulong va) where T : unmanaged;
        void Read(ulong va, Span<byte> data);

        void Write<T>(ulong va, T value) where T : unmanaged;
        void Write(ulong va, ReadOnlySpan<byte> data);

        void Fill(ulong va, ulong size, byte value)
        {
            const int MaxChunkSize = 1 << 30;

            for (ulong subOffset = 0; subOffset < size; subOffset += MaxChunkSize)
            {
                int copySize = (int)Math.Min(MaxChunkSize, size - subOffset);

                GetWritableRegion(va + subOffset, copySize).Memory.Span.Fill(0);
            }
        }

        ReadOnlySpan<byte> GetSpan(ulong va, int size, bool tracked = false);
        WritableRegion GetWritableRegion(ulong va, int size);
        ref T GetRef<T>(ulong va) where T : unmanaged;

        (ulong address, ulong size)[] GetPhysicalRegions(ulong va, ulong size);

        bool IsMapped(ulong va);
        bool IsRangeMapped(ulong va, ulong size);
        ulong GetPhysicalAddress(ulong va);

        void SignalMemoryTracking(ulong va, ulong size, bool write);
        void TrackingReprotect(ulong va, ulong size, MemoryPermission protection);
    }
}