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
程式庫 Sensorsapi.lib
Dll Sensorsapi.dll

另請參閱

ISensor

管理用戶權力

RequestPermissions

感測器類別、類型和數據欄位