HidInputReport Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.Devices.HumanInterfaceDevice
Modifica

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.

Si applica a

Vedi anche