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 |