Share via

Метод ISensorDriver::OnGetDataFields (sensorsclassextension.h)

  • Статья

Метод ISensorDriver::OnGetDataFields извлекает текущие данные датчика.

Синтаксис

HRESULT OnGetDataFields(
  IWDFFile                     *pClientFile,
  LPWSTR                       pwszSensorID,
  IPortableDeviceKeyCollection *pDataFields,
  IPortableDeviceValues        **ppDataValues
);

Параметры

pClientFile

Указатель на интерфейс IWDFFile, представляющий объект файла для приложения, запрашивающего данные.

pwszSensorID

LPWSTR, содержащий идентификатор датчика, с которого клиентское приложение запрашивает данные.

pDataFields

Указатель на коллекцию IPortableDeviceKeyCollection, содержащую список значений PROPERTYKEY, представляющих запрашиваемые поля данных.

ppDataValues

Адрес указателя IPortableDeviceValues, который получает запрошенные данные.

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

Этот метод возвращает HRESULT. Возможные значения включают, помимо прочего, одно из следующих значений.

Код возврата Описание
S_OK Метод выполнен успешно.
HRESULT_FROM_WIN32(ERROR_NO_DATA) У датчика нет данных для отчета. Каждое из полей данных, возвращаемых в параметре ppDataValues, VT_EMPTY.

Комментарии

Поля данных содержат данные, созданные датчиком, в отличие от свойств, которые описывают устройство датчика. Определяемые платформой поля данных определяются в sensors.h.

Каждый объект IPortableDeviceValues , возвращаемый этим методом, должен содержать метку времени, как описано в SENSOR_CATEGORY_ALL.

Расширение класса датчика отвечает за освобождение всех структур PROPVARIANT , возвращаемых этим методом.

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

IPortableDeviceKeyCollection и IPortableDeviceValues описаны в статье Переносные устройства Windows.

Требования

Требование Значение
Целевая платформа Windows
Header sensorsclassextension.h
Библиотека SensorsClassExtension.lib

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

ISensorDriver