Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Important
Utilisez plutôt l’API de capteur UWP .
L’API de capteur COM est déconseillée et ne doit pas être utilisée dans les nouvelles applications. Aucune fonctionnalité ou amélioration supplémentaire n’est planifiée et la prise en charge sera limitée.
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 la valeur 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
La méthode retourne un HRESULT. Les valeurs possibles incluent, mais ne sont pas limitées à celles du tableau suivant.
| Code de retour | Descriptif |
|---|---|
|
La méthode a réussi. |
|
Le pilote de capteur ne prend pas en charge au moins l’une des propriétés spécifiées. Chaque propriété NON prise en charge PROPVARIANT retournée via l’interface IPortableDeviceValues aura sa valeur d’erreur définie sur HRESULT_FROM_WIN32 (ERROR_NOT_FOUND). |
|
NULL a été transmis pour ppProperties. |
Remarques
Cette méthode vous permet de récupérer les valeurs de plusieurs propriétés, telles que la fabrication, 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.
Examples
Pour obtenir un exemple de récupération des propriétés à partir d’un capteur, consultez Définition et récupération des propriétés du capteur.
Spécifications
| Requirement | Valeur |
|---|---|
| Client minimum requis | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Aucun pris en charge |
| plateforme cible | Fenêtres |
| Header | sensorsapi.h |
| Library | Sensorsapi.lib |
| DLL | Sensorsapi.dll |