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
标头 sensorsapi.h
Library Sensorsapi.lib
DLL Sensorsapi.dll

另请参阅

ISensor

管理用户权限

RequestPermissions

传感器类别、类型和数据字段