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

La méthode ISensorDriver ::OnClientConnect avertit le pilote de capteur qu’une application cliente s’est connectée.

Syntaxe

HRESULT OnClientConnect(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

Paramètres

pClientFile

Pointeur vers une interface IWDFFile qui représente l’objet file pour l’application qui demande la connexion.

pwszSensorID

LPWSTR qui contient l’ID du capteur auquel l’application cliente se connecte.

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 uniquement si l’application cliente spécifiée a reçu l’autorisation de l’utilisateur d’accéder au pilote. Si l’utilisateur révoque cette autorisation, l’extension de classe appelle immédiatement ISensorDriver ::OnClientDisconnect pour la même paire application/capteur.

L’extension de classe appelle toujours cette méthode avant d’appeler ISensorDriver ::OnSetProperties ou ISensorDriver ::OnGetDataFields pour un capteur particulier. Nous vous recommandons de conserver un nombre de références d’applications connectées pour vous aider à anticiper quand les appels à ces trois méthodes sont possibles. Si aucune application cliente n’est connectée, vous pouvez modifier le comportement du pilote, par exemple, en prenant des mesures pour réduire la consommation d’énergie.

Vous pouvez utiliser la valeur du pointeur (l’adresse pointée vers) fournie par pClientFile comme type d’ID pour effectuer le suivi des applications connectées. Toutefois, vous devez suivre ces ID séparément pour chaque capteur, et non pour chaque appareil, car l’extension de classe peut fournir la même valeur de pointeur vers plusieurs capteurs sur le même appareil.

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

Configuration requise

Voir aussi

ISensorDriver