ISensor：：GetData 方法 (sensorsapi.h)
擷取最新的感測器數據報告。
語法
HRESULT GetData(
[out] ISensorDataReport **ppDataReport
);
參數
[out] ppDataReport
接收最近感測器數據報表指標的 ISensorDataReport 指標位址。
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
| 傳回碼 | 描述 |
|---|---|
|
此方法已成功。 |
|
感測器驅動程式提供格式不正確的數據。 例如，數據屬於不支援的類型。 如需平臺定義數據欄位數據類型的相關信息，請參閱 感測器類別、類型和數據欄位。 |
|
感測器沒有要報告的數據。 例如，GPS 感測器可能正在取得衛星修正程式。 |
|
已針對ppDataReport傳入NULL。 |
備註
對於位置感測器，您只能從使用者已授與許可權的感測器擷取數據。
這個方法可能會在驅動程式將狀態設定為 SENSOR_STATE_READY 之前傳回數據。
範例
如需如何擷取感測器數據的範例，請參閱 擷取感測器數據值。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | sensorsapi.h |
| 程式庫 | Sensorsapi.lib |
| Dll | Sensorsapi.dll |