ISensorDriver ::OnClientUnsubscribeFromEvents, méthode (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 de fichier de 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 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

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 pour 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 s’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.

Exigences

Exigence	Valeur
plateforme cible	Windows
d’en-tête	sensorsclassextension.h
bibliothèque	SensorsClassExtension.lib

Voir aussi

ISensorDriver