Méthode ISensor ::GetProperties (sensorsapi.h)

Article
03/01/2024

Récupère plusieurs propriétés de capteur.

Syntaxe

HRESULT GetProperties(
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppProperties
);

Paramètres

[in] pKeys

Pointeur vers une interface IPortableDeviceKeyCollection contenant la collection PROPERTYKEY pour les valeurs de propriété demandées. Définissez sur NULL pour récupérer toutes les propriétés prises en charge.

[out] ppProperties

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

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
S_FALSE	Le pilote de capteur ne prend pas en charge au moins l’une des propriétés spécifiées. Chaque propriété PROPVARIANT non prise en charge retournée via l’interface IPortableDeviceValues aura sa valeur d’erreur définie sur HRESULT_FROM_WIN32 (ERROR_NOT_FOUND).
E_POINTER	Null a été passé pour ppProperties.

Remarques

Cette méthode vous permet de récupérer les valeurs de plusieurs propriétés, telles que la make, le modèle et le numéro de série du capteur, en effectuant un seul appel. Pour récupérer une propriété unique, appelez ISensor ::GetProperty.

Les interfaces IPortableDeviceKeyCollection et IPortableDeviceValues sont définies par l’API Appareils portables Windows.

Exemples

Pour obtenir un exemple de récupération de propriétés à partir d’un capteur, consultez Définition et récupération des propriétés du capteur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	sensorsapi.h
Bibliothèque	Sensorsapi.lib
DLL	Sensorsapi.dll

Voir aussi

ISensor

Propriétés du capteur

SetProperties

Partager via