Merge pull request #105 from badcel/restore-read-method-signatures

Restore read method signatures

src/HidApi.Net/Device.cs

@@ -65,6 +65,25 @@ public void Write(ReadOnlySpan<byte> data)
             HidException.Throw(handle);
     }
 
+    /// <summary>
+    /// Returns an input report.
+    /// </summary>
+    /// <param name="maxLength">Max length of the expected data. The value can be greater than the actual report.</param>
+    /// <param name="milliseconds">timeout in milliseconds. -1 for blocking mode.</param>
+    /// <returns>The received data of the HID device. If the timeout is exceeded an empty result is returned.</returns>
+    /// <exception cref="ArgumentOutOfRangeException">Raised if maxlength is smaller than 0</exception>
+    /// <exception cref="HidException">Raised on failure</exception>
+    public ReadOnlySpan<byte> ReadTimeout(int maxLength, int milliseconds)
+    {
+        if (maxLength < 0)
+            throw new ArgumentOutOfRangeException(nameof(maxLength), maxLength, "Please provide a positive value");
+
+        var buffer = new Span<byte>(new byte[maxLength]);
+        var bytesRead = ReadTimeout(buffer, milliseconds);
+
+        return buffer[..bytesRead];
+    }
+
     /// <summary>
     /// Returns an input report.
     /// </summary>
@@ -82,6 +101,24 @@ public int ReadTimeout(Span<byte> buffer, int milliseconds)
         return result;
     }
 
+    /// <summary>
+    /// Returns an input report.
+    /// </summary>
+    /// <param name="maxLength">Max length of the expected data. The value can be greater than the actual report.</param>
+    /// <returns>The received data of the HID device. If non-blocking mode is enabled and no data is available an empty result will be returned.</returns>
+    /// <exception cref="ArgumentOutOfRangeException">Raised if maxlength is smaller than 0</exception>
+    /// <exception cref="HidException">Raised on failure</exception>
+    public ReadOnlySpan<byte> Read(int maxLength)
+    {
+        if (maxLength < 0)
+            throw new ArgumentOutOfRangeException(nameof(maxLength), maxLength, "Please provide a positive value");
+
+        var buffer = new Span<byte>(new byte[maxLength]);
+        var bytesRead = Read(buffer);
+
+        return buffer[..bytesRead];
+    }
+
     /// <summary>
     /// Returns an input report.
     /// </summary>

src/HidApi.Net/HidApi.Net.csproj

@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <VersionPrefix>2.0.0</VersionPrefix>
+    <VersionPrefix>1.1.0</VersionPrefix>
 
     <RootNamespace>HidApi</RootNamespace>
     <AllowUnsafeBlocks>true</AllowUnsafeBlocks>