ISensorDataReport::GetSensorValue method (sensorsapi.h)

Retrieves a single data field value from the data report.

Syntax

HRESULT GetSensorValue(
  [in]  REFPROPERTYKEY pKey,
  [out] PROPVARIANT    *pValue
);

Parameters

[in] pKey

REFPROPERTYKEY indicating the data field to retrieve.

[out] pValue

Address of a PROPVARIANT that receives the data field value.

Return value

This method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
The data field was not found.
E_POINTER
NULL was passed in for pValue.

Remarks

Platform-defined data field PROPERTYKEYs are defined in Sensors.h.

Examples

For an example of how to retrieve a sensor data field value, see Retrieving Sensor Data Values.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header sensorsapi.h
Library Sensorsapi.lib
DLL Sensorsapi.dll

See also

ISensorDataReport