ISensorDriver::OnGetProperties-Methode (sensorsclassextension.h)
Die ISensorDriver::OnGetProperties-Methode ruft Werte für die angegebenen Eigenschaften vom angegebenen Sensor ab.
Syntax
HRESULT OnGetProperties(
IWDFFile *pClientFile,
LPWSTR pwszSensorID,
IPortableDeviceKeyCollection *pProperties,
IPortableDeviceValues **ppPropertyValues
);
Parameter
pClientFile
Zeiger auf eine IWDFFile-Schnittstelle, die das Dateiobjekt für die Anwendung darstellt, die Eigenschaftswerte anfordert.
pwszSensorID
LPWSTR, das die ID für den Sensor enthält, von dem die Clientanwendung Eigenschaftswerte anfordert.
pProperties
Zeiger auf eine IPortableDeviceKeyCollection, die die Liste der PROPERTYKEY-Werte enthält, die die angeforderten Eigenschaften darstellen.
ppPropertyValues
Adresse eines IPortableDeviceValues-Zeigers, der die angeforderten Eigenschaftswerte empfängt.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt diese Methode S_OK zurück. Andernfalls gibt diese Methode einen der Fehlercodes zurück, die in Winerror.h definiert sind.
Hinweise
Eigenschaften beschreiben das Sensorgerät im Gegensatz zu Datenfeldern, die vom Sensor generierte Daten enthalten. Plattformdefinierte Eigenschaften werden in sensors.h definiert.
Anwendungen können auf einige Sensoreigenschafteninformationen zugreifen, bevor der Benutzer die Berechtigung für den Sensor erteilt. Diese Elemente sind auf die folgenden IDs beschränkt, die in sensors.h definiert sind:
- Jeder PROPERTYKEY , der mit "SENSOR_PROPERTY_" beginnt.
- Jede Kategorie-GUID , die mit "SENSOR_CATEGORY_" beginnt.
Die Sensorklassenerweiterung ist für das Freigeben aller PROPVARIANT-Strukturen verantwortlich, die von dieser Methode zurückgegeben werden.
Sensoreigenschaften dürfen keine Informationen enthalten, die zum Identifizieren des Benutzers verwendet werden können. Weitere Informationen zum Datenschutz von Benutzern finden Sie unter Datenschutz und Sicherheit auf der Sensor- und Standortplattform.
IPortableDeviceKeyCollection und IPortableDeviceValues sind unter Tragbare Windows-Geräte dokumentiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | sensorsclassextension.h |
| Bibliothek | SensorsClassExtension.lib |