ISensorDriver::OnSetProperties-Methode (sensorsclassextension.h)

Artikel
02/07/2025

Die ISensorDriver::OnSetProperties Methode gibt Werte für die angegebene Liste der 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-, die 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 Zeiger, der die Liste der Eigenschaften empfängt, die erfolgreich festgelegt wurden, und deren neue Werte. Wenn keine Eigenschaft 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.

Bemerkungen

Eigenschaften beschreiben das Sensorgerät im Gegensatz zu Datenfeldern, die sensorgenerierte Daten enthalten. Plattformdefinierte Eigenschaften werden in sensors.h definiert.

Die Liste der eigenschaften, die über pPropertiesToSet bereitgestellt werden, ist in der Regel eine Teilmenge der Liste, die Sie über ISensorDriver::OnGetSupportedPropertieszurückgegeben haben. Die Sensorklassenerweiterung erzwingt diese Bedingung jedoch nicht für Clientanwendungen.

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

IPortableDeviceValues- ist unter Windows Portable Devices dokumentiert.

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 7,Verfügbar in Windows 7.
mindestens unterstützte Server-	Keine unterstützt
Zielplattform-	Desktop
Header-	sensorsclassextension.h
Library	SensorsClassExtension.lib

Siehe auch

ISensorDriver-

ISensorDriver::OnGetProperties

Freigeben über