ISensor::GetData-Methode (sensorsapi.h)

Ruft den neuesten Sensordatenbericht ab.

Syntax

HRESULT GetData(
  [out] ISensorDataReport **ppDataReport
);

[out] ppDataReport

Adresse eines ISensorDataReport-Zeigers , der den Zeiger auf den neuesten Sensordatenbericht empfängt.

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_INVALIDARG	Der Sensortreiber hat falsch formatierte Daten bereitgestellt. Die Daten waren beispielsweise von einem Typ, der nicht unterstützt wird. Informationen zu Datentypen plattformdefinierter Datenfelder finden Sie unter Sensorkategorien, Typen und Datenfelder.
HRESULT_FROM_WIN32(ERROR_NO_DATA)	Der Sensor verfügt über keine zu meldenden Daten. Beispielsweise könnte ein GPS-Sensor dabei sein, eine Satelliten-Fixierung zu erhalten.
E_POINTER	NULL wurde für ppDataReport übergeben.

Bei Positionssensoren können Sie Daten nur von Sensoren abrufen, für die der Benutzer die Berechtigung erteilt hat.

Diese Methode gibt möglicherweise Daten zurück, bevor der Treiber den Zustand auf SENSOR_STATE_READY festgelegt hat.

Ein Beispiel zum Abrufen von Sensordaten finden Sie unter Abrufen von Sensordatenwerten.

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	sensorsapi.h
Bibliothek	Sensorsapi.lib
DLL	Sensorsapi.dll