ISensorDataReport：：GetSensorValues 方法 (sensorsapi.h)

擷取數據域值的集合。

語法

HRESULT GetSensorValues(
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppValues
);

[in] pKeys

IPortableDeviceKeyCollection 介面的指標，其中包含要擷取值的數據字段。設定為 NULL ，以擷取所有支援數據欄位的值。

[out] ppValues

接收所擷取值的指標的 IPortableDeviceValues 介面指標位址。

方法會傳回 HRESULT。可能的值包括 (但不限於) 下表中的這些值。

傳回碼	描述
S_OK	此方法已成功。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)	找不到數據欄位。檢查 ppValues 以判斷哪些值設定為 ERROR_NOT_FOUND。
E_POINTER	NULL 已針對ppValues傳入。

IPortableDeviceKeyCollection 和 IPortableDeviceValues 介面是由 Windows 可攜式裝置 API 所定義。

當這個方法傳回 HRESULT_FROM_WIN32 (ERROR_NOT_FOUND) 時， IPortableDeviceValues 介面所包含的一或多個結果會設定為 HRESULT 錯誤值。