IAgentCharacterEx::GetSRStatus

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

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

Recupera el estado de la condición necesaria para admitir la entrada de voz.

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

plStatus

Dirección de una variable que recibe uno de los siguientes valores para la creación de estado:

Valor	Descripción
const unsigned long LISTEN_STATUS_CANLISTEN = 0;	Las condiciones admiten la entrada de voz.
const unsigned long LISTEN_STATUS_NOAUDIO = 1;	No hay ningún dispositivo de entrada de audio disponible en este sistema. (Tenga en cuenta que esto no detecta si hay instalado un micrófono; solo puede detectar si el usuario tiene una tarjeta de sonido habilitada para la entrada que esté correctamente instalada con un controlador activo).
const unsigned long LISTEN_STATUS_NOTTOPMOST = 2;	Otro cliente es el cliente activo de este personaje o el personaje actual no está en el nivel superior.
const unsigned long LISTEN_STATUS_CANTOPENAUDIO = 3;	El canal de entrada o salida de audio está ocupado actualmente, hay otra aplicación que está usando el audio.
const unsigned long LISTEN_STATUS_COULDNTINITIALIZESPEECH = 4;	Error no especificado en el proceso de inicialización del subsistema de reconocimiento de voz. Esto incluye la posibilidad de que no haya ningún motor de voz disponible que se corresponda con la configuración de idioma del personaje.
const unsigned long LISTEN_STATUS_SPEECHDISABLED = 5;	El usuario ha deshabilitado la entrada de voz en la ventana Opciones avanzadas de personaje.
const unsigned long LISTEN_STATUS_ERROR = 6;	Error al comprobar el estado de audio, pero el sistema no devolvió la causa del error.

Esta función permite consultar si las condiciones actuales admiten la entrada de reconocimiento de voz, incluido el estado del dispositivo de audio. Si la aplicación usa el método IAgentCharacterEx::Listen, puede usar esta función para asegurarse de que la llamada se realice correctamente. Al llamar a este método también se carga el motor de voz si aún no está cargado. Sin embargo, no activa el modo de escucha.

Cuando la entrada de voz está habilitada en la hoja de propiedades del Agente (Opciones avanzadas de personaje), la consulta del estado cargará el motor asociado (si aún no está cargado) e iniciará los servicios de voz. Es decir, la tecla de escuchar está disponible y se verá la sugerencia de escucha. (La tecla de escuchar y la sugerencia de escucha solo están habilitadas si también lo están en Opciones avanzadas de personaje). Sin embargo, si consulta la propiedad cuando la función de voz está deshabilitada, el servidor no iniciará los servicios de voz.

Esta función devuelve solo la configuración de uso del personaje de la aplicación cliente; la configuración no se aplica a otros clientes del personaje u otros personajes de la aplicación cliente.