5def0429f8
* - WritableRegion: enable wrapping IMemoryOwner<byte> - IVirtualMemoryManager impls of GetWritableRegion() use pooled memory when region is non-contiguous. - IVirtualMemoryManager: add GetReadOnlySequence() and impls - ByteMemoryPool: add new method RentCopy() - ByteMemoryPool: make class static, remove ctor and singleton field from earlier impl * - BytesReadOnlySequenceSegment: move from Ryujinx.Common.Memory to Ryujinx.Memory - BytesReadOnlySequenceSegment: add IsContiguousWith() and Replace() methods - VirtualMemoryManagerBase: - remove generic type parameters, instead use ulong for virtual addresses and nuint for host/physical addresses - implement IWritableBlock - add virtual GetReadOnlySequence() with coalescing of contiguous segments - add virtual GetSpan() - add virtual GetWritableRegion() - add abstract IsMapped() - add virtual MapForeign(ulong, nuint, ulong) - add virtual Read<T>() - add virtual Read(ulong, Span<byte>) - add virtual ReadTracked<T>() - add virtual SignalMemoryTracking() - add virtual Write() - add virtual Write<T>() - add virtual WriteUntracked() - add virtual WriteWithRedundancyCheck() - VirtualMemoryManagerRefCountedBase: remove generic type parameters - AddressSpaceManager: remove redundant methods, add required overrides - HvMemoryManager: remove redundant methods, add required overrides, add overrides for _invalidAccessHandler handling - MemoryManager: remove redundant methods, add required overrides, add overrides for _invalidAccessHandler handling - MemoryManagerHostMapped: remove redundant methods, add required overrides, add overrides for _invalidAccessHandler handling - NativeMemoryManager: add get properties for Pointer and Length - throughout: removed invalid <inheritdoc/> comments * make HvMemoryManager class sealed * remove unused method * adjust MemoryManagerHostTracked * let MemoryManagerHostTracked override WriteImpl()
106 lines
4.5 KiB
C#
106 lines
4.5 KiB
C#
using System;
|
|
using System.Buffers;
|
|
|
|
namespace Ryujinx.Common.Memory
|
|
{
|
|
/// <summary>
|
|
/// Provides a pool of re-usable byte array instances.
|
|
/// </summary>
|
|
public static partial class ByteMemoryPool
|
|
{
|
|
/// <summary>
|
|
/// Returns the maximum buffer size supported by this pool.
|
|
/// </summary>
|
|
public static int MaxBufferSize => Array.MaxLength;
|
|
|
|
/// <summary>
|
|
/// Rents a byte memory buffer from <see cref="ArrayPool{Byte}.Shared"/>.
|
|
/// The buffer may contain data from a prior use.
|
|
/// </summary>
|
|
/// <param name="length">The buffer's required length in bytes</param>
|
|
/// <returns>A <see cref="IMemoryOwner{Byte}"/> wrapping the rented memory</returns>
|
|
/// <exception cref="ArgumentOutOfRangeException"></exception>
|
|
public static IMemoryOwner<byte> Rent(long length)
|
|
=> RentImpl(checked((int)length));
|
|
|
|
/// <summary>
|
|
/// Rents a byte memory buffer from <see cref="ArrayPool{Byte}.Shared"/>.
|
|
/// The buffer may contain data from a prior use.
|
|
/// </summary>
|
|
/// <param name="length">The buffer's required length in bytes</param>
|
|
/// <returns>A <see cref="IMemoryOwner{Byte}"/> wrapping the rented memory</returns>
|
|
/// <exception cref="ArgumentOutOfRangeException"></exception>
|
|
public static IMemoryOwner<byte> Rent(ulong length)
|
|
=> RentImpl(checked((int)length));
|
|
|
|
/// <summary>
|
|
/// Rents a byte memory buffer from <see cref="ArrayPool{Byte}.Shared"/>.
|
|
/// The buffer may contain data from a prior use.
|
|
/// </summary>
|
|
/// <param name="length">The buffer's required length in bytes</param>
|
|
/// <returns>A <see cref="IMemoryOwner{Byte}"/> wrapping the rented memory</returns>
|
|
/// <exception cref="ArgumentOutOfRangeException"></exception>
|
|
public static IMemoryOwner<byte> Rent(int length)
|
|
=> RentImpl(length);
|
|
|
|
/// <summary>
|
|
/// Rents a byte memory buffer from <see cref="ArrayPool{Byte}.Shared"/>.
|
|
/// The buffer's contents are cleared (set to all 0s) before returning.
|
|
/// </summary>
|
|
/// <param name="length">The buffer's required length in bytes</param>
|
|
/// <returns>A <see cref="IMemoryOwner{Byte}"/> wrapping the rented memory</returns>
|
|
/// <exception cref="ArgumentOutOfRangeException"></exception>
|
|
public static IMemoryOwner<byte> RentCleared(long length)
|
|
=> RentCleared(checked((int)length));
|
|
|
|
/// <summary>
|
|
/// Rents a byte memory buffer from <see cref="ArrayPool{Byte}.Shared"/>.
|
|
/// The buffer's contents are cleared (set to all 0s) before returning.
|
|
/// </summary>
|
|
/// <param name="length">The buffer's required length in bytes</param>
|
|
/// <returns>A <see cref="IMemoryOwner{Byte}"/> wrapping the rented memory</returns>
|
|
/// <exception cref="ArgumentOutOfRangeException"></exception>
|
|
public static IMemoryOwner<byte> RentCleared(ulong length)
|
|
=> RentCleared(checked((int)length));
|
|
|
|
/// <summary>
|
|
/// Rents a byte memory buffer from <see cref="ArrayPool{Byte}.Shared"/>.
|
|
/// The buffer's contents are cleared (set to all 0s) before returning.
|
|
/// </summary>
|
|
/// <param name="length">The buffer's required length in bytes</param>
|
|
/// <returns>A <see cref="IMemoryOwner{Byte}"/> wrapping the rented memory</returns>
|
|
/// <exception cref="ArgumentOutOfRangeException"></exception>
|
|
public static IMemoryOwner<byte> RentCleared(int length)
|
|
{
|
|
var buffer = RentImpl(length);
|
|
|
|
buffer.Memory.Span.Clear();
|
|
|
|
return buffer;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Copies <paramref name="buffer"/> into a newly rented byte memory buffer.
|
|
/// </summary>
|
|
/// <param name="buffer">The byte buffer to copy</param>
|
|
/// <returns>A <see cref="IMemoryOwner{Byte}"/> wrapping the rented memory with <paramref name="buffer"/> copied to it</returns>
|
|
public static IMemoryOwner<byte> RentCopy(ReadOnlySpan<byte> buffer)
|
|
{
|
|
var copy = RentImpl(buffer.Length);
|
|
|
|
buffer.CopyTo(copy.Memory.Span);
|
|
|
|
return copy;
|
|
}
|
|
|
|
private static ByteMemoryPoolBuffer RentImpl(int length)
|
|
{
|
|
if ((uint)length > Array.MaxLength)
|
|
{
|
|
throw new ArgumentOutOfRangeException(nameof(length), length, null);
|
|
}
|
|
|
|
return new ByteMemoryPoolBuffer(length);
|
|
}
|
|
}
|
|
}
|