ISensorDriver ::OnClientConnect, méthode (sensorsclassextension.h)
La méthode ISensorDriver ::OnClientConnect avertit le pilote de capteur qu’une application cliente est connectée.
Syntaxe
HRESULT OnClientConnect(
IWDFFile *pClientFile,
LPWSTR pwszSensorID
);
Paramètres
pClientFile
Pointeur vers une interface IWDFFile qui représente l’objet de fichier de l’application demandant la connexion.
pwszSensorID
LPWSTR qui contient l’ID du capteur auquel l’application cliente se connecte.
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 uniquement si l’application cliente spécifiée a été autorisée par l’utilisateur à 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 le moment où 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) 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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | sensorsclassextension.h |
| bibliothèque | SensorsClassExtension.lib |