Méthode ISensorDriver ::OnSetProperties (sensorsclassextension.h)

Article
02/26/2024

La méthode ISensorDriver ::OnSetProperties spécifie des valeurs pour la liste de propriétés spécifiée.

Syntaxe

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

Paramètres

[in] pClientFile

Pointeur vers une interface IWDFFile qui représente l’objet file pour l’application spécifiant des valeurs de propriété.

[in] pwszSensorID

LPWSTR qui contient l’ID du capteur pour lequel l’application cliente spécifie des valeurs de propriété.

[in] pPropertiesToSet

Pointeur vers une interface IPortableDeviceValues qui contient la liste des propriétés à définir et leurs valeurs.

[out] ppResults

Adresse d’un pointeur IPortableDeviceValues qui reçoit la liste des propriétés qui ont été définies avec succès et leurs nouvelles valeurs. Si aucune propriété n’a été définie, la nouvelle valeur contient un code d’erreur HRESULT.

Valeur retournée

Si l’opération réussit, cette méthode retourne S_OK. Sinon, cette méthode retourne l’un des codes d’erreur définis dans Winerror.h.

Remarques

Les propriétés décrivent l’appareil de capteur, par opposition aux champs de données, qui contiennent des données générées par le capteur. Les propriétés définies par la plateforme sont définies dans sensors.h.

La liste des propriétés fournies par le biais de pPropertiesToSet est généralement un sous-ensemble de la liste que vous avez retournée via ISensorDriver ::OnGetSupportedProperties. Toutefois, l’extension de classe de capteur n’applique pas cette condition aux applications clientes.

L’extension de classe de capteur est chargée de libérer toutes les structures PROPVARIANT retournées par cette méthode.

IPortableDeviceValues est documenté dans appareils portables Windows.

Note Cette méthode est appelée uniquement si l’utilisateur a activé le capteur dans le panneau de configuration Location et Autres capteurs .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7, disponible dans Windows 7.
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	sensorsclassextension.h
Bibliothèque	SensorsClassExtension.lib

Voir aussi

ISensorDriver

ISensorDriver ::OnGetProperties

Partager via