Compartir a través de

IAgentNotifySinkEx::ListeningState

  • Artículo

[Microsoft Agent está en desuso a partir de Windows 7 y puede no estar disponible en versiones posteriores de Windows].

HRESULT ListeningState(
   long dwCharacterID,  // character ID
   long bListening,     // listening mode state
   long dwCause         // cause  
);

Notifica a una aplicación cliente cuándo cambia el modo de escucha.

  • No devuelve ningún valor.

dwCharacterID

Carácter para el que cambió el estado de escucha.

bListening

Estado del modo de escucha. True indica que se ha iniciado el modo de escucha; False indica que el modo de escucha ha finalizado.

dwCause

Causa del evento, que puede tener uno de los siguientes valores.

Valor Descripción
const unsigned long LSCOMPLETE_CAUSE_PROGRAMDISABLED = 1;
 El código del programa desactivó el modo de escucha.
const unsigned long LSCOMPLETE_CAUSE_PROGRAMTIMEDOUT = 2;
 Se ha agotado el tiempo de espera del modo de escucha (activado por código de programa).
const unsigned long LSCOMPLETE_CAUSE_USERTIMEDOUT = 3;
 Se ha agotado el tiempo de espera del modo de escucha (activado por la tecla de escucha).
const unsigned long LSCOMPLETE_CAUSE_USERRELEASEDKEY = 4;
 El modo de escucha se desactivó porque el usuario soltó la tecla de escucha.
const unsigned long LSCOMPLETE_CAUSE_USERUTTERANCEENDED = 5;
 El modo de escucha se desactivó porque el usuario terminó de hablar.
const unsigned long LSCOMPLETE_CAUSE_CLIENTDEACTIVATED = 6;
 El modo de escucha se desactivó porque se desactivó el cliente activo de entrada.
const unsigned long LSCOMPLETE_CAUSE_DEFAULTCHARCHANGE = 7
 El modo de escucha se desactivó porque se cambió el carácter predeterminado.
const unsigned long LSCOMPLETE_CAUSE_USERDISABLED = 8
 El modo de escucha se desactivó porque el usuario deshabilitó la entrada de voz.

Este evento se envía a todos los clientes cuando el modo de escucha comienza después de que el usuario pulse la tecla Escucha o cuando finalice su tiempo de espera, o cuando el cliente de entrada-activo llame al método IAgentCharacterEx::Listen con True o False.

El evento devuelve valores a los clientes que actualmente tienen cargado este carácter. Todos los demás clientes reciben un carácter null (cadena vacía).

Consulte también

IAgentCharacterEx::Listen