Поделиться через


Метод ISensor::GetData (sensorsapi.h)

Извлекает последний отчет о данных датчика.

Синтаксис

HRESULT GetData(
  [out] ISensorDataReport **ppDataReport
);

Параметры

[out] ppDataReport

Адрес указателя ISensorDataReport , который получает указатель на последний отчет о данных датчика.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
Метод выполнен успешно.
E_INVALIDARG
Драйвер датчика предоставил данные неправильного формата. Например, данные были типа, который не поддерживается. Сведения о типах данных в полях данных, определяемых платформой, см. в разделе Категории, типы и поля данных датчика.
HRESULT_FROM_WIN32(ERROR_NO_DATA)
У датчика нет данных для передачи. Например, датчик GPS может находиться в процессе получения спутниковой фиксации.
E_POINTER
Для ppDataReport передано значение NULL.

Комментарии

Для датчиков расположения данные можно получать только с датчиков, для которых пользователь предоставил разрешение.

Этот метод может возвращать данные до того, как драйвер установит состояние SENSOR_STATE_READY.

Примеры

Пример получения данных датчика см. в разделе Получение значений данных датчика.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header sensorsapi.h
Библиотека Sensorsapi.lib
DLL Sensorsapi.dll

См. также раздел

ISensor

Управление разрешениями пользователей

RequestPermissions

Категории, типы и поля данных датчика