Compartir a través de

IAgentCharacterEx::GetSRModeID

  • Artículo

[Microsoft Agent está en desuso a partir de Windows 7 y puede no estar disponible en versiones posteriores de Windows.

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

Recupera el identificador de modo del motor de reconocimiento de voz establecido para el carácter.

  • Devuelve S_OK para indicar que la operación se realizó correctamente.

pbszModeID

Dirección de un BSTR que recibe la configuración del identificador de modo del motor de reconocimiento de voz para el carácter.

Esta configuración devuelve el conjunto de motores para la entrada de voz de un carácter. El identificador de modo de un motor de reconocimiento de voz es una representación de cadena del GUID (con formato de llaves y guiones) por parte del proveedor de voz que identifica de forma única el motor. Para más información, consulte la documentación del SDK de Microsoft Speech.

Si no establece un identificador de modo del motor de reconocimiento de voz para el carácter, el servidor devuelve un motor que coincide con la configuración de idioma del carácter (mediante interfaces de Microsoft Speech API). Si no hay ningún motor de reconocimiento de voz coincidente disponible para el carácter, el servidor devuelve una cadena nula (vacía).

Cuando se habilita la entrada de voz (en la ventana Opciones avanzadas de caracteres), al consultar o establecer esta propiedad, se cargará el motor asociado (si aún no está cargado) y se iniciarán los servicios de voz. Es decir, la tecla escucha está disponible y se puede mostrar la sugerencia de escucha. (La tecla de escucha y la sugerencia de escucha solo están habilitadas si también están habilitadas en Opciones avanzadas de caracteres). Sin embargo, si consulta la propiedad cuando la voz está deshabilitada, el servidor no inicia los servicios de voz y devuelve una cadena nula (cadena vacía).

Esta función devuelve solo la configuración para el uso del carácter de la aplicación cliente; la configuración no refleja otros clientes del carácter u otros caracteres de la aplicación cliente.

Esta función no produce un error si IAgentSpeechInputProperties::GetEnabled devuelve False.

Los requisitos del motor de voz de Microsoft Agent se basan en Microsoft Speech API. Los motores que admiten los requisitos de SAPI de Microsoft Agent se pueden instalar y usar con el Agente.

Consulte también

IAgentCharacterEx::SetSRModeID