Condividi tramite

IAgentCharacterEx::GetSRModeID

  • Articolo

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

HRESULT GetSRModeID(
   BSTR * pbszModeID  // address of speech recognition engine ID
);

Recupera l'ID modalità del motore di riconoscimento vocale impostato per il carattere.

  • Restituisce S_OK per indicare che l'operazione è riuscita.

pbszModeID

Indirizzo di un BSTR che riceve l'impostazione dell'ID modalità del motore di riconoscimento vocale per il carattere.

Questa impostazione restituisce il motore impostato per l'input vocale di un carattere. L'ID modalità per un motore di riconoscimento vocale è una rappresentazione di stringa del GUID (formattato con parentesi graffe e trattini) dal fornitore del riconoscimento vocale identificando in modo univoco il motore. Per altre informazioni, vedere la documentazione di Microsoft Speech SDK.

Se non si imposta un ID modalità motore di riconoscimento vocale per il carattere, il server restituisce un motore che corrisponde all'impostazione della lingua del carattere (usando le interfacce dell'API Riconoscimento vocale Microsoft). Se non è disponibile alcun motore di riconoscimento vocale corrispondente per il carattere, il server restituisce una stringa null (vuota).

Quando l'input vocale è abilitato (nella finestra Opzioni carattere avanzate), l'esecuzione di query o l'impostazione di questa proprietà caricherà il motore associato (se non è già caricato) e avvierà i servizi voce. Vale a dire, la chiave di ascolto è disponibile e il suggerimento di 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 e restituisce una stringa Null (stringa vuota).

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.

Questa funzione non riesce se IAgentSpeechInputProperties::GetEnabled restituisceFalse.

I requisiti del motore di riconoscimento vocale di Microsoft Agent si basano sull'API Riconoscimento vocale Microsoft. I motori che supportano i requisiti SAPI di Microsoft Agent possono essere installati e usati con Agent.

Vedere anche

IAgentCharacterEx::SetSRModeID