寻求C#中读取HID设备报告的通用方法

假设用户的提问是："How do I create a custom Input Provider for IOWrapper to support a niche hardware API?"，以下是Stack Overflow风格的回答：

Hey there! As the author of IOWrapper, I’ve walked through this process countless times—let me break it down step by step for you.

Core Concepts to Remember #

First, a quick recap: Providers are MEF plugins that wrap specific IO APIs. To build one, you’ll need to implement two key interfaces shipped with IOWrapper:

• IInputProvider: Handles enumerating devices, reading input states, and device event subscriptions.
• IInputDevice: Represents a single input device (e.g., a custom keyboard or specialized controller) exposed by your API.

Step 1: Set Up Your Project #

• Create a new Class Library project (.NET Framework/.NET Core, depending on your IOWrapper version).
• Add a reference to the IOWrapper.Core package (either via NuGet or local assembly if working from source).
• Enable MEF support by adding the System.ComponentModel.Composition NuGet package.

Step 2: Implement the Input Device #

Start with the device class, as it’s the building block. Here’s a simplified example for a hypothetical niche API:

[Export(typeof(IInputDevice))]
public class NicheApiInputDevice : IInputDevice
{
    private IntPtr _deviceHandle;

    // Required properties
    public Guid DeviceId { get; private set; }
    public string DeviceName { get; private set; }
    public InputDeviceType DeviceType { get; private set; } = InputDeviceType.Controller;

    // Initialize the device using your niche API
    public bool Initialize(IntPtr deviceHandle)
    {
        _deviceHandle = deviceHandle;
        // Fetch actual device info from your hardware API
        DeviceId = Guid.NewGuid(); // Replace with unique ID from your device
        DeviceName = "Niche Hardware Controller";
        return true;
    }

    // Read the latest input state
    public InputState ReadState()
    {
        var state = new InputState();
        // Populate state with data from your niche API
        state.Buttons.Add(new InputButton { Id = "CustomButton1", IsPressed = NicheApi.IsButtonPressed(_deviceHandle, 0) });
        state.Axes.Add(new InputAxis { Id = "CustomAxisX", Value = NicheApi.GetAxisValue(_deviceHandle, 0) });
        return state;
    }

    // Cleanup resources
    public void Dispose()
    {
        NicheApi.CloseDevice(_deviceHandle);
    }
}

Step 3: Build the Provider Class #

Next, the provider handles device enumeration and manages instances of your device:

[Export(typeof(IInputProvider))]
public class NicheApiInputProvider : IInputProvider
{
    public string ProviderName => "Niche Hardware API Provider";

    public IEnumerable<IInputDevice> EnumerateDevices()
    {
        var devices = new List<IInputDevice>();
        // Use your niche API to list connected devices
        var deviceHandles = NicheApi.EnumerateDevices();
        foreach (var handle in deviceHandles)
        {
            var device = new NicheApiInputDevice();
            if (device.Initialize(handle))
            {
                devices.Add(device);
            }
        }
        return devices;
    }

    // Initialize the underlying API
    public void Initialize()
    {
        NicheApi.Initialize();
    }

    // Shutdown the API
    public void Dispose()
    {
        NicheApi.Shutdown();
    }
}

Step 4: Deploy the Provider #

• Build your class library.
• Copy the resulting DLL into the Providers folder of your IOWrapper application (this folder is scanned automatically on startup).
• Launch your app—IOWrapper will use MEF to discover and load your new provider!

Pro Tips #

• Error Handling: Add try/catch blocks around API calls to gracefully handle hardware disconnects or API errors.
• Testing: Use the IOWrapper.Tools utility (included with the library) to test your provider and verify device states.
• MEF Metadata: Add metadata attributes to your exports (e.g., [ExportMetadata("ApiVersion", "1.0")]) to make your provider more discoverable.

If you run into specific issues (like MEF discovery problems or API quirks), feel free to share more details—I’m happy to help!

内容的提问来源于stack exchange，提问作者Clive Galway