Méthode ISensor ::GetData (sensorsapi.h)
Récupère le rapport de données de capteur le plus récent.
Syntaxe
HRESULT GetData(
[out] ISensorDataReport **ppDataReport
);
Paramètres
[out] ppDataReport
Adresse d’un pointeur ISensorDataReport qui reçoit le pointeur vers le rapport de données de capteur le plus récent.
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 |
|
Le pilote de capteur a fourni des données mal formées. Par exemple, les données étaient d’un type qui n’est pas pris en charge. Pour plus d’informations sur les types de données des champs de données définis par la plateforme, consultez Catégories de capteurs, Types et Champs de données. |
|
Le capteur n’a aucune donnée à signaler. Par exemple, un capteur GPS peut être en cours d’acquisition d’un correctif satellite. |
|
Null a été passé pour ppDataReport. |
Remarques
Pour les capteurs d’emplacement, vous pouvez récupérer des données uniquement à partir de capteurs pour lesquels l’utilisateur a accordé l’autorisation.
Cette méthode peut retourner des données avant que le pilote n’ait défini l’état sur SENSOR_STATE_READY.
Exemples
Pour obtenir un exemple de récupération des données de capteur, consultez Récupération de valeurs de données de 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 |