Condividi tramite

IAgentNotifySinkEx::ListeningState

  • Articolo

[Microsoft Agent è deprecato a partire da Windows 7 e potrebbe non essere disponibile nelle versioni successive di Windows.]

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

Notifica a un'applicazione client quando cambia la modalità di ascolto.

  • Nessun valore restituito.

dwCharacterID

Carattere per il quale lo stato di ascolto è cambiato.

bListening

Stato modalità di ascolto. True indica che la modalità di ascolto è stata avviata; False, la modalità di ascolto è terminata.

dwCause

Causa dell'evento, che può essere uno dei valori seguenti.

valore Descrizione
const unsigned long LSCOMPLETE_CAUSE_PROGRAMDISABLED = 1;
 La modalità di ascolto è stata disattivata dal codice del programma.
const unsigned long LSCOMPLETE_CAUSE_PROGRAMTIMEDOUT = 2;
 Timeout della modalità di ascolto (attivato dal codice del programma).
const unsigned long LSCOMPLETE_CAUSE_USERTIMEDOUT = 3;
 Timeout della modalità di ascolto (attivato dal tasto Di ascolto).
const unsigned long LSCOMPLETE_CAUSE_USERRELEASEDKEY = 4;
 La modalità di ascolto è stata disattivata perché l'utente ha rilasciato il tasto Di ascolto.
const unsigned long LSCOMPLETE_CAUSE_USERUTTERANCEENDED = 5;
 La modalità di ascolto è stata disattivata perché l'utente ha terminato di parlare.
const unsigned long LSCOMPLETE_CAUSE_CLIENTDEACTIVATED = 6;
 La modalità di ascolto è stata disattivata perché il client attivo di input è stato disattivato.
const unsigned long LSCOMPLETE_CAUSE_DEFAULTCHARCHANGE = 7
 La modalità di ascolto è stata disattivata perché il carattere predefinito è stato modificato.
const unsigned long LSCOMPLETE_CAUSE_USERDISABLED = 8
 La modalità di ascolto è stata disattivata perché l'utente ha disabilitato l'input vocale.

Questo evento viene inviato a tutti i client quando viene avviata la modalità Di ascolto dopo che l'utente preme il tasto Listen o quando termina il timeout o quando il client attivo di input chiama il metodo IAgentCharacterEx::Listen con True o False.

L'evento restituisce valori ai client in cui è attualmente caricato questo carattere. Tutti gli altri client ricevono un carattere Null (stringa vuota).

Vedi anche

IAgentCharacterEx::Listen