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

Article
02/26/2024

La méthode ISensorDriver ::OnGetProperties récupère les valeurs des propriétés spécifiées à partir du capteur spécifié.

Syntaxe

HRESULT OnGetProperties(
  IWDFFile                     *pClientFile,
  LPWSTR                       pwszSensorID,
  IPortableDeviceKeyCollection *pProperties,
  IPortableDeviceValues        **ppPropertyValues
);

Paramètres

pClientFile

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

pwszSensorID

LPWSTR qui contient l’ID du capteur à partir duquel l’application cliente demande des valeurs de propriété.

pProperties

Pointeur vers un IPortableDeviceKeyCollection qui contient la liste des valeurs PROPERTYKEY qui représentent les propriétés demandées.

ppPropertyValues

Adresse d’un pointeur IPortableDeviceValues qui reçoit les valeurs de propriété demandées.

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.

Les applications peuvent accéder à certaines informations de propriété du capteur avant que l’utilisateur n’accorde l’autorisation pour le capteur. Ces éléments sont limités aux ID suivants définis dans sensors.h :

N’importe quelle PROPRIÉTÉKEY qui commence par « SENSOR_PROPERTY_ ».
GUID de catégorie commençant par « SENSOR_CATEGORY_ ».

Chaque objet IPortableDeviceValues retourné dans cette collection doit contenir des valeurs pour les propriétés requises, comme décrit dans la section de référence Propriétés du capteur .

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

Les propriétés du capteur ne doivent pas contenir d’informations qui peuvent être utilisées pour identifier l’utilisateur. Pour plus d’informations sur la confidentialité des utilisateurs, consultez Confidentialité et sécurité dans la plateforme capteur et emplacement.

IPortableDeviceKeyCollection et IPortableDeviceValues sont documentés dans les appareils portables Windows.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	sensorsclassextension.h
Bibliothèque	SensorsClassExtension.lib

Voir aussi

ISensorDriver

Partager via