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

La méthode ISensorDriver ::OnClientUnsubscribeFromEvents avertit le pilote de capteur qu’une application cliente ne demande plus de notifications d’événements.

Syntaxe

HRESULT OnClientUnsubscribeFromEvents(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

Paramètres

pClientFile

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

pwszSensorID

LPWSTR qui contient l’ID du capteur à partir duquel l’application cliente demande l’annulation 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

L’extension de classe de capteur appelle cette méthode dans les instances suivantes :

• Une application se désabonne des événements.
• Une application se ferme normalement.
• L’utilisateur révoque l’autorisation permettant à une application d’accéder à l’appareil qui contient le capteur spécifié.
• L’extension de classe de capteur s’arrête.
• Le travail de nettoyage à partir d’un appel à ISensorClassExtension ::CleanupFile est terminé.

Vous pouvez utiliser cet appel comme signal pour mettre à jour le nombre de références d’applications demandant des événements pour le capteur spécifié.

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

La structure ClientData est définie comme suit.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	sensorsclassextension.h
Bibliothèque	SensorsClassExtension.lib

Voir aussi

ISensorDriver