Méthode ISensorDriver ::OnSetProperties (sensorsclassextension.h)
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 de fichier de 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’une IPortableDeviceValues pointeur qui reçoit la liste des propriétés qui ont été définies avec succès et leurs nouvelles valeurs. Si une propriété n’a pas été définie, la nouvelle valeur contient un code d’erreur HRESULT.
Valeur de retour
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 via 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 les appareils portables Windows.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 7, disponible dans Windows 7. |
| serveur minimum pris en charge | Aucun pris en charge |
| plateforme cible | Bureau |
| d’en-tête | sensorsclassextension.h |
| bibliothèque | SensorsClassExtension.lib |