HidDevice Classe

Définition

public ref class HidDevice sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class HidDevice final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class HidDevice : System.IDisposable

Public NotInheritable Class HidDevice
Implements IDisposable

Héritage

Object Platform::Object IInspectable HidDevice

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Implémente

IClosable IDisposable

Configuration requise pour Windows

Exemples

Pour obtenir un exemple complet qui montre comment utiliser cette classe, consultez Exemple d’appareil HID personnalisé.

L’exemple suivant montre comment une application UWP créée avec XAML et C# utilise la méthode GetDeviceSelector pour créer un sélecteur pour un appareil HID spécifique (dans ce cas, Microsoft Input Configuration Device), puis utilise la méthode FromIdAsync pour ouvrir une connexion à cet appareil.

using System;
using System.Linq;
using Windows.Devices.Enumeration;
using Windows.Devices.HumanInterfaceDevice;
using Windows.Storage;
using Windows.UI.Xaml.Controls;

namespace HIDdeviceTest
{
    public sealed partial class MainPage : Page
    {
        public MainPage()
        {
            this.InitializeComponent();
            EnumerateHidDevices();
        }

        // Find HID devices.
        private async void EnumerateHidDevices()
        {
            // Microsoft Input Configuration Device.
            ushort vendorId = 0x045E;
            ushort productId = 0x07CD;
            ushort usagePage = 0x000D;
            ushort usageId = 0x000E;

            // Create the selector.
            string selector = 
                HidDevice.GetDeviceSelector(usagePage, usageId, vendorId, productId);

            // Enumerate devices using the selector.
            var devices = await DeviceInformation.FindAllAsync(selector);

            if (devices.Any())
            {
                // At this point the device is available to communicate with
                // So we can send/receive HID reports from it or 
                // query it for control descriptions.
                info.Text = "HID devices found: " + devices.Count;

                // Open the target HID device.
                HidDevice device = 
                    await HidDevice.FromIdAsync(devices.ElementAt(0).Id,
                    FileAccessMode.ReadWrite);

                if (device != null)
                {
                    // Input reports contain data from the device.
                    device.InputReportReceived += async (sender, args) =>
                    {
                        HidInputReport inputReport = args.Report;
                        IBuffer buffer = inputReport.Data;

                        // Create a DispatchedHandler as we are interracting with the UI directly and the
                        // thread that this function is running on might not be the UI thread; 
                        // if a non-UI thread modifies the UI, an exception is thrown.

                        await this.Dispatcher.RunAsync(
                            CoreDispatcherPriority.Normal,
                            new DispatchedHandler(() =>
                            {
                                info.Text += "\nHID Input Report: " + inputReport.ToString() + 
                                "\nTotal number of bytes received: " + buffer.Length.ToString();
                            }));
                    };
                }

            }
            else
            {
                // There were no HID devices that met the selector criteria.
                info.Text = "HID device not found";
            }
        }
    }
}

Remarques

Pour plus d’informations sur l’utilisation de cette classe, y compris les limitations, consultez Prise en charge des appareils d’interface humaine (HID) et Exemple d’appareil HID personnalisé.

Les applications qui utilisent cette classe pour accéder à un appareil HID doivent inclure des données DeviceCapability spécifiques dans le nœud Fonctionnalités de son manifeste. Ces données identifient l’appareil et son objectif (ou fonction). Pour plus d’informations, consultez Comment spécifier des fonctionnalités d’appareil pour HID.

Propriétés

Méthodes

Événements

S’applique à

Voir aussi

• Guide pratique pour spécifier les capacités d’un appareil pour HID
• Prise en charge des appareils d’interface humaine (HID)
• Exemple d’appareil HID personnalisé