HidInputReport Classe

Definição

Namespace:

Windows.Devices.HumanInterfaceDevice

Representa um relatório de entrada HID.

Os dispositivos emitem relatórios de entrada para descrever alterações de estado, entrada do usuário e outros dados específicos do dispositivo. Por exemplo, um dispositivo de teclado HID usaria um relatório de entrada para sinalizar uma tecla. Um sensor de presença hid usaria um relatório de entrada para sinalizar um evento de detecção de presença.

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

Herança

Object Platform::Object IInspectable HidInputReport

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

O exemplo a seguir demonstra como um aplicativo UWP criado com XAML e C# usa o método GetInputReportAsync para obter um relatório de entrada.

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");
            }
        }
    }
}

Propriedades

ActivatedBooleanControls	Obtém os controles boolianos ativados no momento para o dispositivo HID especificado.
Data	Obtém os dados associados a um determinado relatório de entrada.
Id	Obtém o identificador associado a um determinado relatório de entrada.
TransitionedBooleanControls	Obtém os controles boolianos recém-transitórios para o dispositivo HID especificado.

Métodos

GetBooleanControl(UInt16, UInt16)	Recupera o controle booliano associado ao parâmetro usagePage e usageId e encontrado no relatório de entrada fornecido.
GetBooleanControlByDescription(HidBooleanControlDescription)	Recupera o controle booliano descrito pelo parâmetro controlDescription e encontrado no relatório de entrada especificado.
GetNumericControl(UInt16, UInt16)	Recupera o controle numérico associado aos parâmetros usagePage e usageId e encontrado no relatório de entrada fornecido.
GetNumericControlByDescription(HidNumericControlDescription)	Recupera o controle numérico descrito pelo parâmetro controlDescription e encontrado no relatório de entrada especificado.

Confira também

• Exemplo de dispositivo HID personalizado