Méthode ISensorDriver ::OnGetDataFields (sensorsclassextension.h)

La méthode ISensorDriver ::OnGetDataFields récupère les données actuelles du capteur.

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 pour l’application qui demande 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 retournée

Cette méthode retourne un HRESULT. Les valeurs possibles incluent, sans s’y limiter, l’une des valeurs suivantes.

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 du 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 Panneau de configuration.

IPortableDeviceKeyCollection et IPortableDeviceValues sont documentés dans les appareils portables Windows.

Configuration requise

Voir aussi

ISensorDriver