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 de fichier de 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 de retour
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 à 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 lorsqu’il 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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | sensorsclassextension.h |
| bibliothèque | SensorsClassExtension.lib |