ISensorDriver：：OnGetDataFields 方法 (sensorsclassextension.h)

  • 项目

ISensorDriver：：OnGetDataFields 方法检索当前传感器数据。

语法

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

参数

pClientFile

指向 IWDFFile 接口的指针，该接口表示请求数据的应用程序的文件对象。

pwszSensorID

包含客户端应用程序从中请求数据的传感器的 ID 的 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
标头 sensorsclassextension.h
Library SensorsClassExtension.lib

另请参阅

ISensorDriver