HidDevice.GetInputReportAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
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)
Возвращаемое значение
Объект HidInputReport .
- Атрибуты
Примеры
Здесь мы извлекаем входной отчет (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 и получить свойство Report объекта HidInputReportReceivedEventArgs в обработчике событий.
Устройство должно быть открыто с помощью 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
Определяет запрошенный входной отчет.
Возвращаемое значение
Объект HidInputReport .
- Атрибуты
Примеры
Здесь мы извлекаем входной отчет (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 и получить свойство Report объекта HidInputReportReceivedEventArgs в обработчике событий.
Устройство должно быть открыто с помощью fileAccessMode.Read или FileAccessMode.ReadWrite.