ISensorDriver::OnGetDataFields-Methode (sensorsclassextension.h)

Die ISensorDriver::OnGetDataFields-Methode ruft aktuelle Sensordaten ab.

Syntax

HRESULT OnGetDataFields(
  IWDFFile                     *pClientFile,
  LPWSTR                       pwszSensorID,
  IPortableDeviceKeyCollection *pDataFields,
  IPortableDeviceValues        **ppDataValues
);

Parameter

pClientFile

Zeiger auf eine IWDFFile-Schnittstelle, die das Dateiobjekt für die Anwendung darstellt, die die Daten anfordert.

pwszSensorID

LPWSTR, das die ID für den Sensor enthält, von dem die Clientanwendung Daten anfordert.

pDataFields

Zeiger auf eine IPortableDeviceKeyCollection, die die Liste der PROPERTYKEY-Werte enthält, die die angeforderten Datenfelder darstellen.

ppDataValues

Adresse eines IPortableDeviceValues-Zeigers, der die angeforderten Daten empfängt.

Rückgabewert

Diese Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem einer der folgenden Werte.

Rückgabecode	Beschreibung
S_OK	Die Methode wurde erfolgreich ausgeführt.
HRESULT_FROM_WIN32(ERROR_NO_DATA)	Der Sensor hat keine Daten zu melden. Jedes der im ppDataValues-Parameter zurückgegebenen Datenfelder ist VT_EMPTY.

Hinweise

Datenfelder enthalten vom Sensor generierte Daten im Gegensatz zu Eigenschaften, die das Sensorgerät beschreiben. Plattformdefinierte Datenfelder werden in sensors.h definiert.

Jedes IPortableDeviceValues-Objekt , das von dieser Methode zurückgegeben wird, muss einen Zeitstempel enthalten, wie in SENSOR_CATEGORY_ALL beschrieben.

Die Sensorklassenerweiterung ist für das Freigeben aller von dieser Methode zurückgegebenen PROPVARIANT-Strukturen verantwortlich.

Die Sensorklassenerweiterung ruft diese Methode nur für Sensoren auf, für die der Benutzer die Berechtigung über Systemsteuerung erteilt hat.

IPortableDeviceKeyCollection und IPortableDeviceValues sind in Tragbare Windows-Geräte dokumentiert.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	sensorsclassextension.h
Bibliothek	SensorsClassExtension.lib

Weitere Informationen

ISensorDriver