HidDevice.GetInputReportAsync Método

Definição

Namespace:

Windows.Devices.HumanInterfaceDevice

Sobrecargas

GetInputReportAsync()	Recupera de forma assíncrona o relatório de entrada padrão ou o primeiro do dispositivo HID especificado.
GetInputReportAsync(UInt16)	Recupera de forma assíncrona um relatório de entrada, identificado pelo parâmetro reportId , do dispositivo HID especificado.

GetInputReportAsync()

Recupera de forma assíncrona o relatório de entrada padrão ou o primeiro do dispositivo HID especificado.

public:
 virtual IAsyncOperation<HidInputReport ^> ^ GetInputReportAsync() = GetInputReportAsync;

/// [Windows.Foundation.Metadata.Overload("GetInputReportAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<HidInputReport> GetInputReportAsync();

[Windows.Foundation.Metadata.Overload("GetInputReportAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<HidInputReport> GetInputReportAsync();

function getInputReportAsync()

Public Function GetInputReportAsync () As IAsyncOperation(Of HidInputReport)

Retornos

IAsyncOperation<HidInputReport>

Um objeto HidInputReport .

Atributos

OverloadAttribute RemoteAsyncAttribute

Exemplos

Aqui, recuperamos um relatório de entrada (inputReport) e obtemos o conteúdo do relatório no manipulador para o evento InputReportReceived, disparado quando a chamada assíncrona é concluída.

HidInputReport inputReport = await device.GetInputReportAsync();
.
.
.
private void InputReportReceived(
    HidDevice sender, 
    HidInputReportReceivedEventArgs args)
    {
        HidInputReport inputReport = args.Report;
        IBuffer buffer = inputReport.Data;
        DataReader dr = DataReader.FromBuffer(buffer);
        byte[] bytes = new byte[inputReport.Data.Length];
        dr.ReadBytes(bytes);

        String inputReportContent = 
           System.Text.Encoding.ASCII.GetString(bytes);
    }

Comentários

Quando esse método é concluído, o evento InputReportReceived é disparado.

Para acessar o conteúdo do relatório de entrada, você deve configurar um ouvinte para o evento InputReportReceived e obter a propriedade Report do objeto HidInputReportReceivedEventArgs no manipulador de eventos.

O dispositivo deve ser aberto com FileAccessMode.Read ou FileAccessMode.ReadWrite.

GetInputReportAsync(UInt16)

Recupera de forma assíncrona um relatório de entrada, identificado pelo parâmetro reportId , do dispositivo HID especificado.

public:
 virtual IAsyncOperation<HidInputReport ^> ^ GetInputReportAsync(unsigned short reportId) = GetInputReportAsync;

/// [Windows.Foundation.Metadata.Overload("GetInputReportByIdAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<HidInputReport> GetInputReportAsync(uint16_t const& reportId);

[Windows.Foundation.Metadata.Overload("GetInputReportByIdAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<HidInputReport> GetInputReportAsync(ushort reportId);

function getInputReportAsync(reportId)

Public Function GetInputReportAsync (reportId As UShort) As IAsyncOperation(Of HidInputReport)

Parâmetros

reportId

UInt16

unsigned short

uint16_t

Identifica o relatório de entrada solicitado.

Retornos

IAsyncOperation<HidInputReport>

Um objeto HidInputReport .

Atributos

OverloadAttribute RemoteAsyncAttribute

Exemplos

Aqui, recuperamos um relatório de entrada (inputReport) e obtemos o conteúdo do relatório no manipulador para o evento InputReportReceived, disparado quando a chamada assíncrona é concluída.

HidInputReport inputReport = await device.GetInputReportAsync();
.
.
.
private void InputReportReceived(
    HidDevice sender, 
    HidInputReportReceivedEventArgs args)
    {
        HidInputReport inputReport = args.Report;
        IBuffer buffer = inputReport.Data;
        DataReader dr = DataReader.FromBuffer(buffer);
        byte[] bytes = new byte[inputReport.Data.Length];
        dr.ReadBytes(bytes);

        String inputReportContent = 
           System.Text.Encoding.ASCII.GetString(bytes);
    }

Comentários

Quando esse método é concluído, o evento InputReportReceived é disparado.

Para acessar o conteúdo do relatório de entrada, você deve configurar um ouvinte para o evento InputReportReceived e obter a propriedade Report do objeto HidInputReportReceivedEventArgs no manipulador de eventos.

O dispositivo deve ser aberto com FileAccessMode.Read ou FileAccessMode.ReadWrite.