ISensorDriver::OnGetProperties-Methode (sensorsclassextension.h)

Artikel
02/07/2025

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

Zeigen Sie 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.

Bemerkungen

Eigenschaften beschreiben das Sensorgerät im Gegensatz zu Datenfeldern, die sensorgenerierte 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 in dieser Auflistung zurückgegebene IPortableDeviceValues--Objekt muss Werte für die erforderlichen Eigenschaften enthalten, wie im Sensoreigenschaften Referenzabschnitt beschrieben.

Die Sensorklassenerweiterung ist dafür verantwortlich, alle von dieser Methode zurückgegebenen PROPVARIANT- Strukturen freizugeben.

Sensoreigenschaften dürfen keine Informationen enthalten, mit denen der Benutzer identifiziert werden kann. Weitere Informationen zum Datenschutz finden Sie unter Datenschutz und Sicherheit in der Sensor- und Standortplattform.

IPortableDeviceKeyCollection und IPortableDeviceValues- werden auf tragbaren Windows-Geräten dokumentiert.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	sensorsclassextension.h
Library	SensorsClassExtension.lib

Siehe auch

ISensorDriver-

Freigeben über