IAgentNotifySinkEx::ListeningState

  • Artigo

[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]

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

Notifica um aplicativo cliente quando o modo escuta é alterado.

  • Sem valor de retorno.

dwCharacterID

O caractere para o qual o estado de escuta foi alterado.

bListening

O estado do modo de escuta. True indica que o modo de escuta foi iniciado; False, esse modo de escuta terminou.

dwCause

A causa do evento, que pode ser um dos valores a seguir.

Valor Descrição
const unsigned longLSCOMPLETE_CAUSE_PROGRAMDISABLED = 1;
 O modo de escuta foi desativado pelo código do programa.
const unsigned longLSCOMPLETE_CAUSE_PROGRAMTIMEDOUT = 2;
 O modo de escuta (ativado pelo código do programa) atingiu o tempo limite.
const unsigned longLSCOMPLETE_CAUSE_USERTIMEDOUT = 3;
 O modo de escuta (ativado pela tecla Listening) atingiu o tempo limite.
const unsigned longLSCOMPLETE_CAUSE_USERRELEASEDKEY = 4;
 O modo de escuta foi desativado porque o usuário liberou a tecla Listening.
const unsigned longLSCOMPLETE_CAUSE_USERUTTERANCEENDED = 5;
 O modo de escuta foi desativado porque o usuário terminou de falar.
const unsigned longLSCOMPLETE_CAUSE_CLIENTDEACTIVATED = 6;
 O modo de escuta foi desativado porque o cliente ativo de entrada foi desativado.
const unsigned longLSCOMPLETE_CAUSE_DEFAULTCHARCHANGE = 7
 O modo de escuta foi desativado porque o caractere padrão foi alterado.
const unsigned longLSCOMPLETE_CAUSE_USERDISABLED = 8
 O modo de escuta foi desativado porque o usuário desabilitou a entrada de fala.

Esse evento é enviado a todos os clientes quando o modo escuta começa depois que o usuário pressiona a tecla Listening ou quando seu tempo limite termina, ou quando o cliente ativo de entrada chama o método IAgentCharacterEx::Listen com True ou False.

O evento retorna valores para os clientes que atualmente têm esse caractere carregado. Todos os outros clientes recebem um caractere nulo (cadeia de caracteres vazia).

Consulte Também

IAgentCharacterEx::Listen