HidDevice.GetInputReportAsync メソッド

定義

名前空間:

Windows.Devices.HumanInterfaceDevice

オーバーロード

GetInputReportAsync()	指定された HID デバイスから既定の入力レポート (最初) を非同期的に取得します。
GetInputReportAsync(UInt16)	reportId パラメーターによって識別される入力レポートを、指定された HID デバイスから非同期的に取得します。

GetInputReportAsync()

指定された HID デバイスから既定の入力レポート (最初) を非同期的に取得します。

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)

戻り値

IAsyncOperation<HidInputReport>

HidInputReport オブジェクト。

属性

OverloadAttribute RemoteAsyncAttribute

例

ここでは、入力レポート (inputReport) を取得し、非同期呼び出しが完了したときにトリガーされる InputReportReceived イベントのハンドラーでレポートの内容を取得します。

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

注釈

このメソッドが完了すると、 InputReportReceived イベントがトリガーされます。

入力レポートの内容にアクセスするには、InputReportReceived イベントのリスナーを設定し、イベント ハンドラーで HidInputReportReceivedEventArgs オブジェクトの Report プロパティを取得する必要があります。

デバイスは、 FileAccessMode.Read または FileAccessMode.ReadWrite を使用して開く必要があります。

GetInputReportAsync(UInt16)

reportId パラメーターによって識別される入力レポートを、指定された HID デバイスから非同期的に取得します。

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)

パラメーター

reportId

UInt16

unsigned short

uint16_t

要求された入力レポートを識別します。

戻り値

IAsyncOperation<HidInputReport>

HidInputReport オブジェクト。

属性

OverloadAttribute RemoteAsyncAttribute

例

ここでは、入力レポート (inputReport) を取得し、非同期呼び出しが完了したときにトリガーされる InputReportReceived イベントのハンドラーでレポートの内容を取得します。

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

注釈

このメソッドが完了すると、 InputReportReceived イベントがトリガーされます。

入力レポートの内容にアクセスするには、InputReportReceived イベントのリスナーを設定し、イベント ハンドラーで HidInputReportReceivedEventArgs オブジェクトの Report プロパティを取得する必要があります。

デバイスは、 FileAccessMode.Read または FileAccessMode.ReadWrite を使用して開く必要があります。