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。 可能的值包括但不限于以下值之一。

言论

数据字段包含传感器生成的数据，而不是描述传感器设备的属性。 平台定义的数据字段在 sensors.h 中定义。

此方法返回的每个 IPortableDeviceValues 对象都必须包含时间戳，如 SENSOR_CATEGORY_ALL中所述。

传感器类扩展负责释放此方法返回的任何 PROPVARIANT 结构。

传感器类扩展仅对用户通过控制面板授予权限的传感器调用此方法。

IPortableDeviceKeyCollection 和 IPortableDeviceValues 记录在 Windows 可移植设备中。

要求

另请参阅

ISensorDriver