IAgentNotifySinkEx::ListeningState

[O Microsoft Agent foi preterido do Windows 7 em diante e pode não estar disponível em 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 de escuta é alterado.

• Nenhum valor retornado.

dwCharacterID

O caractere para o qual o estado de escuta mudou.

bListening

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

dwCause

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

Valor	Descrição
const unsigned long LSCOMPLETE_CAUSE_PROGRAMDISABLED = 1;	O modo de escuta foi desativado pelo código do programa.
const unsigned long LSCOMPLETE_CAUSE_PROGRAMTIMEDOUT = 2;	O modo de escuta (ativado pelo código do programa) atingiu o tempo limite.
const unsigned long LSCOMPLETE_CAUSE_USERTIMEDOUT = 3;	O modo de escuta (ativado pela tecla Listening) atingiu o tempo limite.
const unsigned long LSCOMPLETE_CAUSE_USERRELEASEDKEY = 4;	O modo de escuta foi desativado porque o usuário soltou a tecla Listening.
const unsigned long LSCOMPLETE_CAUSE_USERUTTERANCEENDED = 5;	O modo de escuta foi desativado porque o usuário terminou de falar.
const unsigned long LSCOMPLETE_CAUSE_CLIENTDEACTIVATED = 6;	O modo de escuta foi desativado porque o cliente ativo de entrada foi desativado.
const unsigned long LSCOMPLETE_CAUSE_DEFAULTCHARCHANGE = 7	O modo de escuta foi desativado porque o caractere padrão foi alterado.
const unsigned long LSCOMPLETE_CAUSE_USERDISABLED = 8	O modo de escuta foi desativado porque o usuário desativou a entrada de fala.

Esse evento é enviado a todos os clientes quando o modo de escuta começa depois que o usuário pressiona a tecla Listening, quando o 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).

Confira também

IAgentCharacterEx::Listen