feat: add IMaaDisposable.IsStateless

Author: moomiji

src/MaaFramework.Binding.UnitTests/Test_Buffers.cs

@@ -1101,6 +1101,7 @@ public bool ThrowOnInvalid
         get => throw new NotImplementedException();
         set => throw new NotImplementedException();
     }
+    public bool IsStateless => throw new NotImplementedException();
     public bool IsEmpty => throw new NotImplementedException();
     public bool TryClear() => throw new NotImplementedException();
     public ImageInfo GetInfo() => throw new NotImplementedException();
@@ -1126,6 +1127,7 @@ public bool ThrowOnInvalid
         get => throw new NotImplementedException();
         set => throw new NotImplementedException();
     }
+    public bool IsStateless => throw new NotImplementedException();
     public bool IsEmpty => throw new NotImplementedException();
     public ulong Size => throw new NotImplementedException();
     public bool TryClear() => throw new NotImplementedException();
@@ -1143,6 +1145,7 @@ public bool ThrowOnInvalid
         get => throw new NotImplementedException();
         set => throw new NotImplementedException();
     }
+    public bool IsStateless => throw new NotImplementedException();
     public int X => throw new NotImplementedException();
     public int Y => throw new NotImplementedException();
     public int Width => throw new NotImplementedException();

src/MaaFramework.Binding.UnitTests/Test_Custom.cs

@@ -35,7 +35,10 @@ public bool Analyze(in IMaaContext context, in AnalyzeArgs args, in AnalyzeResul
             Assert.AreEqual(NodeName, args.NodeName);
             Assert.AreEqual(RecognitionParam, args.RecognitionParam);
 
-            _ = Assert.ThrowsException<ArgumentException>(() => new MaaContext(IntPtr.Zero));
+            _ = Assert.ThrowsException<ArgumentException>(() =>
+#if MAA_NATIVE
+                new MaaContext(IntPtr.Zero));
+#endif
             var cloneContext = (context as ICloneable).Clone() as IMaaContext;
             cloneContext = cloneContext?.Clone();
 #if MAA_NATIVE
@@ -105,7 +108,7 @@ public bool Run(in IMaaContext context, in RunArgs args)
         }
     }
 
-    internal sealed class TestController(MaaController c) : IMaaCustomController, IMaaDisposable
+    internal sealed class TestController(IMaaController c) : IMaaCustomController, IMaaDisposable
     {
         #region Test_IMaaDisposable
 
@@ -117,6 +120,8 @@ public bool ThrowOnInvalid
             set => c.ThrowOnInvalid = value;
         }
 
+        public bool IsStateless => c.IsStateless;
+
         public void Dispose() => c.Dispose();
 
         #endregion
@@ -137,7 +142,9 @@ public bool PressKey(int keycode)
 
         public bool RequestResolution(out int width, out int height)
         {
+#if MAA_NATIVE           
             using var image = new MaaImageBuffer();
+#endif
             if (Screencap(image))
             {
                 width = image.Width;

src/MaaFramework.Binding/Abstractions/IMaaDisposable.cs

@@ -11,9 +11,17 @@ public interface IMaaDisposable : IDisposable
     bool IsInvalid { get; }
 
     /// <summary>
-    ///     Gets a value indicating whether an <see cref="ObjectDisposedException"/> is thrown when current instance is invalid but still called.
+    ///     Gets a value indicating whether an <see cref="ObjectDisposedException"/> is thrown when the current instance is invalid but still called.
     /// </summary>
     bool ThrowOnInvalid { get; set; }
+
+    /// <summary>
+    ///     Gets a value indicating whether the current instance is stateless.
+    /// </summary>
+    /// <remarks>
+    ///     The lifetime of unmanaged resources is controlled by <see cref="MaaFramework"/>.
+    /// </remarks>
+    bool IsStateless { get; }
 }
 
 //  设计思路：

src/MaaFramework.Binding/Abstractions/MaaDisposableHandle.cs

@@ -45,6 +45,9 @@ public void SetHandleAsInvalid()
     /// <inheritdoc/>
     public bool ThrowOnInvalid { get; set; }
 
+    /// <inheritdoc/>
+    public bool IsStateless => !_needReleased;
+
     /// <summary>
     ///     Creates a <see cref="MaaDisposableHandle{T}"/> instance.
     /// </summary>

src/MaaFramework.Binding/MaaImage.cs

@@ -25,6 +25,9 @@ public bool ThrowOnInvalid
         set => buffer.ThrowOnInvalid = value;
     }
 
+    /// <inheritdoc/>
+    public bool IsStateless => buffer.IsStateless;
+
     /// <summary>
     ///     Caches the image data from the <see cref="IMaaImageBuffer"/>.
     /// </summary>