ISensorDriver::OnSetProperties-Methode (sensorsclassextension.h)

Die ISensorDriver::OnSetProperties-Methode gibt Werte für die angegebene Liste von Eigenschaften an.

Syntax

HRESULT OnSetProperties(
  [in]  IWDFFile              *pClientFile,
  [in]  LPWSTR                pwszSensorID,
  [in]  IPortableDeviceValues *pPropertiesToSet,
  [out] IPortableDeviceValues **ppResults
);

Parameter

[in] pClientFile

Zeiger auf eine IWDFFile-Schnittstelle , die das Dateiobjekt für die Anwendung darstellt, die Eigenschaftswerte angibt.

[in] pwszSensorID

LPWSTR , das die ID für den Sensor enthält, für den die Clientanwendung Eigenschaftswerte angibt.

[in] pPropertiesToSet

Zeiger auf eine IPortableDeviceValues-Schnittstelle , die die Liste der festzulegenden Eigenschaften und deren Werte enthält.

[out] ppResults

Adresse eines IPortableDeviceValues-Zeigers , der die Liste der erfolgreich festgelegten Eigenschaften und ihre neuen Werte empfängt. Wenn eine Eigenschaft nicht festgelegt wurde, enthält der neue Wert einen HRESULT-Fehlercode.

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.

Die Liste der über pPropertiesToSet bereitgestellten Eigenschaften ist in der Regel eine Teilmenge der Liste, die Sie über ISensorDriver::OnGetSupportedProperties zurückgegeben haben. Die Sensorklassenerweiterung erzwingt diese Bedingung jedoch nicht für Clientanwendungen.

Die Sensorklassenerweiterung ist für das Freigeben aller von dieser Methode zurückgegebenen PROPVARIANT-Strukturen verantwortlich.

IPortableDeviceValues ist in Tragbare Windows-Geräte dokumentiert.

Hinweis Diese Methode wird nur aufgerufen, wenn der Benutzer den Sensor in der Systemsteuerung Standort- und andere Sensoren aktiviert hat.

 

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7, Verfügbar in Windows 7.
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Desktop
Kopfzeile	sensorsclassextension.h
Bibliothek	SensorsClassExtension.lib

Weitere Informationen

ISensorDriver

ISensorDriver::OnGetProperties