Add Read overloads for passing in buffer

[TimonLukas]

Implements #101

Warning: I did tested this only briefly (with a short bit of temporary code in HidApi.Tester). Can you recommend a good way to test it beyond that?

The method signatures had to slightly change compared to what we last discussed in the issue:

public interface IDevice {
    int Read(Span<byte> buffer);
    int ReadTimeout(Span<byte> buffer, int milliseconds);

    // removed based on discussion
    // ReadOnlySpan<byte> Read(int maxLength);
    // ReadOnlySpan<byte> ReadTimeout(int maxLength, int milliseconds);
}

As the Read might not fill the whole buffer, the new overloads have to return the read length. I believe this is another good reason to leave the previous signatures intact, as they prevent this mistake.

[badcel]

This looks already pretty good I added some remarks for small improvements.

Unfortunately I don't have devices to test this too. A detailed look must be sufficient.

If you have done the changes please squash all your changes into one commit to avoid having several commits for such a minimal change.

[TimonLukas]

There, now it's clean. Sorry for the oversights!

[badcel]

The code is not free of obsolete whitespaces, this is why the build fails. Please run dotnet format in the src folder to fix the issue automatically.

Please amend your changes to the last commit to avoid an additional commit.

After this the PR is good to go 🚀.

[TimonLukas]

There we go. Unfortunately dotnet format leads to an unhandled exception in the project, seems my current installation is somehow broken - but I believe I fixed the previous issue.