HidInputReport Classe

Definizione

Spazio dei nomi:

Windows.Devices.HumanInterfaceDevice

Rappresenta un report di input HID.

I dispositivi generano report di input per descrivere le modifiche dello stato, l'input utente e altri dati specifici del dispositivo. Ad esempio, un dispositivo tastiera HID userebbe un report di input per segnalare una pressione del tasto. Un sensore di presenza HID userebbe un report di input per segnalare un evento di rilevamento della presenza.

public ref class HidInputReport sealed

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

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class HidInputReport

Public NotInheritable Class HidInputReport

Ereditarietà

Object Platform::Object IInspectable HidInputReport

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Nell'esempio seguente viene illustrato come un'app UWP compilata con XAML e C# usi il metodo GetInputReportAsync per ottenere un report di input.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

using Windows.Devices.Enumeration;
using Windows.Devices.HumanInterfaceDevice;
using Windows.Storage;
using Windows.Storage.Streams;

namespace HidSampleCS
{
    class Vendor
    {
        private async void ReadWriteToHidDevice(HidDevice device)
        {
            if (device != null)
            {
                // construct a HID output report to send to the device
                HidOutputReport outReport = device.CreateOutputReport();

                /// Initialize the data buffer and fill it in
                byte[] buffer = new byte[] { 10, 20, 30, 40 };

                DataWriter dataWriter = new DataWriter();
                dataWriter.WriteBytes(buffer);

                outReport.Data = dataWriter.DetachBuffer();

                // Send the output report asynchronously
                await device.SendOutputReportAsync(outReport);

                //
                // Sent output report successfully 
                // Now lets try read an input report 
                //
                HidInputReport inReport = await device.GetInputReportAsync();

                if (inReport != null)
                {
                    UInt16 id = inReport.Id;
                    var bytes = new byte[4];
                    DataReader dataReader = DataReader.FromBuffer(inReport.Data);
                    dataReader.ReadBytes(bytes);
                }
                else
                {
                    this.NotifyUser("Invalid input report received");
                }
            }
            else
            {
                this.NotifyUser("device is NULL");
            }
        }
    }
}

Proprietà

ActivatedBooleanControls	Ottiene i controlli booleani attualmente attivati per il dispositivo HID specificato.
Data	Ottiene i dati associati a un report di input specificato.
Id	Ottiene l'identificatore associato a un determinato report di input.
TransitionedBooleanControls	Ottiene i controlli booleani passati di recente per il dispositivo HID specificato.

Metodi

GetBooleanControl(UInt16, UInt16)	Recupera il controllo booleano associato al parametro usagePage e usageId e trovato nel report di input specificato.
GetBooleanControlByDescription(HidBooleanControlDescription)	Recupera il controllo Boolean descritto dal parametro controlDescription e trovato nel report di input specificato.
GetNumericControl(UInt16, UInt16)	Recupera il controllo numerico associato ai parametri usagePage e usageId e trovato nel report di input specificato.
GetNumericControlByDescription(HidNumericControlDescription)	Recupera il controllo numerico descritto dal parametro controlDescription e trovato nel report di input specificato.

Vedi anche

• Esempio di dispositivo HID personalizzato