ISensorDataReport::GetSensorValue-Methode (sensorsapi.h)

Von Bedeutung

Verwenden Sie stattdessen die UWP-Sensor-API .

Die COM-basierte Sensor-API ist veraltet und sollte nicht in neuen Anwendungen verwendet werden. Es sind keine zusätzlichen Features oder Verbesserungen geplant, und der Support wird eingeschränkt.

Ruft einen einzelnen Datenfeldwert aus dem Datenbericht ab.

Syntax

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

Die Parameter

[in] pKey

REFPROPERTYKEY , der das abzurufende Datenfeld angibt.

[out] pValue

Adresse eines PROPVARIANT , das den Datenfeldwert empfängt.

Rückgabewert

Diese Methode gibt ein HRESULT zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

Rückgabecode Description
S_OK
Die Methode war erfolgreich.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
Das Datenfeld wurde nicht gefunden.
E_POINTER
NULL wurde für pValue übergeben.

Bemerkungen

Das plattformdefinierte Datenfeld PROPERTYKEYs wird in Sensors.h definiert.

Examples

Ein Beispiel zum Abrufen eines Sensordatenfeldwerts finden Sie unter Abrufen von Sensordatenwerten.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 7 [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Nicht unterstützt
Zielplattform Fenster
Header sensorsapi.h
Library Sensorsapi.lib
DLL Sensorsapi.dll

Siehe auch

ISensorDataReport