IAgentNotifySinkEx::ListeningState

[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 longLSCOMPLETE_CAUSE_PROGRAMDISABLED = 1;
La modalità di ascolto è stata disattivata dal codice del programma.
const unsigned longLSCOMPLETE_CAUSE_PROGRAMTIMEDOUT = 2;
Timeout della modalità di ascolto (attivato dal codice del programma).
const unsigned longLSCOMPLETE_CAUSE_USERTIMEDOUT = 3;
Timeout della modalità di ascolto (attivato dal tasto di ascolto).
const unsigned longLSCOMPLETE_CAUSE_USERRELEASEDKEY = 4;
La modalità di ascolto è stata disattivata perché l'utente ha rilasciato il tasto Di ascolto.
const unsigned longLSCOMPLETE_CAUSE_USERUTTERANCEENDED = 5;
La modalità di ascolto è stata disattivata perché l'utente ha terminato di parlare.
const unsigned longLSCOMPLETE_CAUSE_CLIENTDEACTIVATED = 6;
La modalità di ascolto è stata disattivata perché il client attivo di input è stato disattivato.
const unsigned longLSCOMPLETE_CAUSE_DEFAULTCHARCHANGE = 7
La modalità di ascolto è stata disattivata perché il carattere predefinito è stato modificato.
const unsigned longLSCOMPLETE_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 la modalità di ascolto inizia 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).

Vedere anche

IAgentCharacterEx::Listen