Méthode ISensorDriver ::OnGetDataFields (sensorsclassextension.h)
La méthode ISensorDriver ::OnGetDataFields récupère les données de capteur actuelles.
Syntaxe
HRESULT OnGetDataFields(
IWDFFile *pClientFile,
LPWSTR pwszSensorID,
IPortableDeviceKeyCollection *pDataFields,
IPortableDeviceValues **ppDataValues
);
Paramètres
pClientFile
Pointeur vers une interface IWDFFile qui représente l’objet de fichier de l’application demandant les données.
pwszSensorID
LPWSTR qui contient l’ID du capteur à partir duquel l’application cliente demande des données.
pDataFields
Pointeur vers un IPortableDeviceKeyCollection qui contient la liste des valeurs PROPERTYKEY qui représentent les champs de données demandés.
ppDataValues
Adresse d’un pointeur IPortableDeviceValues qui reçoit les données demandées.
Valeur de retour
Cette méthode retourne un HRESULT. Les valeurs possibles incluent, mais ne sont pas limitées à, l’une des valeurs suivantes.
| code de retour | Description |
|---|---|
| S_OK | La méthode a réussi. |
| HRESULT_FROM_WIN32(ERROR_NO_DATA) | Le capteur n’a pas de données à signaler. Chacun des champs de données retournés dans le paramètre ppDataValues est VT_EMPTY. |
Remarques
Les champs de données contiennent des données générées par le capteur, par opposition aux propriétés, qui décrivent l’appareil de capteur. Les champs de données définis par la plateforme sont définis dans sensors.h.
Chaque objet IPortableDeviceValues retourné par cette méthode doit contenir un horodatage, comme décrit dans SENSOR_CATEGORY_ALL.
L’extension de classe de capteur est chargée de libérer toutes les structures PROPVARIANT retournées par cette méthode.
L’extension de classe de capteur appelle cette méthode uniquement pour les capteurs pour lesquels l’utilisateur a accordé l’autorisation via le Panneau de configuration.
IPortableDeviceKeyCollection et IPortableDeviceValues sont documentés dans les appareils portables Windows.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | sensorsclassextension.h |
| bibliothèque | SensorsClassExtension.lib |