IAgentNotifySinkEx::ListeningState
[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible dans les versions ultérieures de Windows.]
HRESULT ListeningState(
long dwCharacterID, // character ID
long bListening, // listening mode state
long dwCause // cause
);
Notifie une application cliente lorsque le mode d'écoute change.
- Aucune valeur renvoyée.
-
dwCharacterID
-
Le caractère pour lequel l'état d'écoute a changé.
-
bListening
-
L'état du mode d'écoute. True indique que le mode d'écoute a commencé ; False, que le mode d'écoute est terminé.
-
dwCause
-
La cause de l'événement, qui peut être l'une des valeurs suivantes.
Valeur Description const unsigned long LSCOMPLETE_CAUSE_PROGRAMDISABLED = 1; Le mode d'écoute a été désactivé par le code du programme. const unsigned long LSCOMPLETE_CAUSE_PROGRAMTIMEDOUT = 2; Le mode d'écoute (activé par le code du programme) a expiré. const unsigned long LSCOMPLETE_CAUSE_USERTIMEDOUT = 3; Le mode d'écoute (activé par la touche d'écoute) a expiré. const unsigned long LSCOMPLETE_CAUSE_USERRELEASEDKEY = 4; Le mode d'écoute a été désactivé parce que l'utilisateur a relâché la touche d'écoute. const unsigned long LSCOMPLETE_CAUSE_USERUTTERANCEENDED = 5; Le mode d'écoute a été désactivé parce que l'utilisateur a fini de parler. const unsigned long LSCOMPLETE_CAUSE_CLIENTDEACTIVATED = 6; Le mode d'écoute a été désactivé parce que le client actif d'entrée a été désactivé. const unsigned long LSCOMPLETE_CAUSE_DEFAULTCHARCHANGE = 7 Le mode d'écoute a été désactivé parce que le caractère par défaut a été modifié. const unsigned long LSCOMPLETE_CAUSE_USERDISABLED = 8 Le mode d'écoute a été désactivé parce que l'utilisateur a désactivé l'entrée vocale.
Cet événement est envoyé à tous les clients lorsque le mode d'écoute commence après que l'utilisateur a appuyé sur la touche d'écoute ou lorsque son délai d'attente se termine, ou lorsque le client actif en entrée appelle la méthode IAgentCharacterEx::Listen avec True ou False.
L'événement renvoie des valeurs aux clients qui ont actuellement ce caractère chargé. Tous les autres clients reçoivent un caractère nul (chaîne vide).