ISensorDriver::OnGetProperties-Methode (sensorsclassextension.h)

Artikel
02/29/2024

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.

Jedes IPortableDeviceValues-Objekt , das in dieser Auflistung zurückgegeben wird, muss Werte für die erforderlichen Eigenschaften enthalten, wie im Abschnitt Sensoreigenschaftenreferenz beschrieben.

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

Weitere Informationen

ISensorDriver

Freigeben über