Partager via


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

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 l’identificateur de la catégorie de capteur.

Syntaxe

HRESULT GetCategory(
  [out] SENSOR_CATEGORY_ID *pSensorCategory
);

Paramètres

[out] pSensorCategory

Adresse d’un SENSOR_CATEGORY_ID qui reçoit l’ID de catégorie de capteur.

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
S_OK
La méthode a réussi.
E_UNEXPECTED
Le pilote de capteur n’a pas fourni de valeur de catégorie. La propriété PROPVARIANT retournée aura sa valeur d’erreur définie sur HRESULT_FROM_WIN32 (ERROR_NOT_FOUND).
E_POINTER
NULL a été transmis pour pSensorCategory.

Remarques

Un SENSOR_CATEGORY_ID est un GUID qui identifie de manière unique la catégorie de 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

Voir aussi

ISensor

catégories de capteurs, types et champs de données