IAgentCharacterEx::GetSRStatus

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

HRESULT GetSRStatus(
   long * plStatus  // address of the speech input status
);

Recupera lo stato della condizione necessaria per supportare l'input vocale.

• Restituisce S_OK per indicare che l'operazione è stata completata correttamente.

plStatus

Indirizzo di una variabile che riceve uno dei valori seguenti per l'impostazione dello stato:

valore	Descrizione
const unsigned long LISTEN_STATUS_CANLISTEN = 0;	Le condizioni supportano l'input vocale.
const unsigned long LISTEN_STATUS_NOAUDIO = 1;	In questo sistema non è disponibile alcun dispositivo di input audio. Si noti che questo non rileva se è installato un microfono; può rilevare solo se l'utente dispone di una scheda audio abilitata per l'input correttamente installata con un driver funzionante.
const unsigned long LISTEN_STATUS_NOTTOPMOST = 2;	Un altro client è il client attivo di questo carattere oppure il carattere corrente non è all'inizio.
const unsigned long LISTEN_STATUS_CANTOPENAUDIO = 3;	Il canale di input audio o di output è attualmente occupato, altre applicazioni usano l'audio.
const unsigned long LISTEN_STATUS_COULDNTINITIALIZESPEECH = 4;	Si è verificato un errore non specificato durante il processo di inizializzazione del sottosistema di riconoscimento vocale. Ciò include la possibilità che non sia disponibile alcun motore di riconoscimento vocale corrispondente all'impostazione della lingua del carattere.
const unsigned long LISTEN_STATUS_SPEECHDISABLED = 5;	L'utente ha disabilitato l'input vocale nella finestra Opzioni carattere avanzate.
const unsigned long LISTEN_STATUS_ERROR = 6;	Si è verificato un errore durante il controllo dello stato audio, ma la causa dell'errore non è stata restituita dal sistema.

Questa funzione consente di verificare se le condizioni correnti supportano l'input di riconoscimento vocale, incluso lo stato del dispositivo audio. Se l'applicazione usa il metodo IAgentCharacterEx::Listen , è possibile usare questa funzione per assicurarsi che la chiamata abbia esito positivo. Se non è già stato caricato, la chiamata a questo metodo carica anche il motore di riconoscimento vocale. Tuttavia, non attiva la modalità di ascolto.

Quando l'input vocale è abilitato nella finestra delle proprietà agente (Opzioni carattere avanzate), l'esecuzione di query sullo stato caricherà il motore associato (se non è già caricato) e avvierà i servizi voce. Ovvero, il tasto Di ascolto è disponibile e il suggerimento per l'ascolto è visualizzabile. Il tasto di ascolto e il suggerimento per l'ascolto sono abilitati solo se sono abilitati anche in Opzioni carattere avanzate. Tuttavia, se si esegue una query sulla proprietà quando il riconoscimento vocale è disabilitato, il server non avvia i servizi voce.

Questa funzione restituisce solo l'impostazione per l'uso del carattere dell'applicazione client; l'impostazione non riflette altri client del carattere o di altri caratteri dell'applicazione client.