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

La méthode ISensorDriver ::OnClientSubscribeToEvents avertit le pilote de capteur qu’une application cliente autorisée demande des notifications d’événements.

Syntaxe

HRESULT OnClientSubscribeToEvents(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

Paramètres

pClientFile

Pointeur vers une interface IWDFFile qui représente l’objet file pour l’application demandant des notifications d’événements.

pwszSensorID

LPWSTR qui contient l’ID du capteur à partir duquel l’application cliente demande des notifications d’événements.

Valeur retournée

Si l’opération réussit, cette méthode retourne S_OK. Sinon, cette méthode retourne l’un des codes d’erreur définis dans Winerror.h.

Remarques

Lorsqu’une application cliente demande des notifications d’événements, le pilote déclenche tous les événements vers l’extension de classe de capteur pour l’ID d’objet spécifié. L’extension de classe transfère ensuite ces événements à l’API Sensor en tant que notifications d’événements pour les applications.

Vous pouvez conserver un nombre de références d’applications connectées pour chaque capteur afin d’éviter d’effectuer des rappels d’événements lorsque ce n’est pas nécessaire.

Les événements définis par la plateforme sont définis dans sensors.h.

Pour plus d’informations sur l’utilisation de cette méthode, consultez Filtrage des données.

Configuration requise

Voir aussi

ISensorDriver