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
Zeigen Sie 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
Zeigen Sie 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, aber nicht beschränkt auf einen der folgenden Werte.
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Die Methode war erfolgreich. |
| HRESULT_FROM_WIN32(ERROR_NO_DATA) | Der Sensor hat keine Zu meldenden Daten. Jedes der im PpDataValues-Parameter zurückgegebenen Datenfelder wird VT_EMPTY. |
Bemerkungen
Datenfelder enthalten sensorgenerierte Daten im Gegensatz zu Eigenschaften, die das Sensorgerät beschreiben. Plattformdefinierte Datenfelder werden in sensors.h definiert.
Jedes IPortableDeviceValues- von dieser Methode zurückgegebene Objekt muss einen Zeitstempel enthalten, wie in SENSOR_CATEGORY_ALLbeschrieben.
Die Sensorklassenerweiterung ist dafür verantwortlich, alle von dieser Methode zurückgegebenen PROPVARIANT- Strukturen freizugeben.
Die Sensorklassenerweiterung ruft diese Methode nur für Sensoren auf, für die der Benutzer die Berechtigung über die Systemsteuerung erteilt hat.
IPortableDeviceKeyCollection und IPortableDeviceValues- werden auf tragbaren Windows-Geräten dokumentiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | sensorsclassextension.h |
| Library | SensorsClassExtension.lib |