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 |