HidDevice.GetInputReportAsync Methode

Definition

Namespace:

Windows.Devices.HumanInterfaceDevice

Überlädt

GetInputReportAsync()	Ruft den Standard- oder ersten Eingabebericht asynchron vom angegebenen HID-Gerät ab.
GetInputReportAsync(UInt16)	Ruft asynchron einen Eingabebericht ab, der durch den reportId-Parameter identifiziert wird, vom angegebenen HID-Gerät.

GetInputReportAsync()

Ruft den Standard- oder ersten Eingabebericht asynchron vom angegebenen HID-Gerät ab.

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)

Gibt zurück

IAsyncOperation<HidInputReport>

Ein HidInputReport-Objekt .

Attribute

OverloadAttribute RemoteAsyncAttribute

Beispiele

Hier rufen wir einen Eingabebericht (inputReport) ab und rufen den Inhalt des Berichts im Handler für das InputReportReceived-Ereignis ab, das ausgelöst wird, wenn der asynchrone Aufruf abgeschlossen ist.

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

Hinweise

Wenn diese Methode abgeschlossen ist, wird das InputReportReceived-Ereignis ausgelöst.

Um auf den Inhalt des Eingabeberichts zuzugreifen, müssen Sie einen Listener für das InputReportReceived-Ereignis einrichten und die Report-Eigenschaft des HidInputReportReceivedEventArgs-Objekts im Ereignishandler abrufen.

Das Gerät muss entweder mit FileAccessMode.Read oder FileAccessMode.ReadWrite geöffnet werden.

GetInputReportAsync(UInt16)

Ruft asynchron einen Eingabebericht ab, der durch den reportId-Parameter identifiziert wird, vom angegebenen HID-Gerät.

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)

Parameter

reportId

UInt16

unsigned short

uint16_t

Identifiziert den angeforderten Eingabebericht.

Gibt zurück

IAsyncOperation<HidInputReport>

Ein HidInputReport-Objekt .

Attribute

OverloadAttribute RemoteAsyncAttribute

Beispiele

Hier rufen wir einen Eingabebericht (inputReport) ab und rufen den Inhalt des Berichts im Handler für das InputReportReceived-Ereignis ab, das ausgelöst wird, wenn der asynchrone Aufruf abgeschlossen ist.

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

Hinweise

Wenn diese Methode abgeschlossen ist, wird das InputReportReceived-Ereignis ausgelöst.

Um auf den Inhalt des Eingabeberichts zuzugreifen, müssen Sie einen Listener für das InputReportReceived-Ereignis einrichten und die Report-Eigenschaft des HidInputReportReceivedEventArgs-Objekts im Ereignishandler abrufen.

Das Gerät muss entweder mit FileAccessMode.Read oder FileAccessMode.ReadWrite geöffnet werden.