IAgentCharacterEx::GetSRStatus
[O Microsoft Agent foi preterido do Windows 7 em diante e pode não estar disponível em versões subsequentes do Windows.]
HRESULT GetSRStatus(
long * plStatus // address of the speech input status
);
Recupera o status da condição necessária para dar suporte à entrada de fala.
- Retorna S_OK para indicar que a operação foi bem-sucedida.
-
plStatus
-
Endereço de uma variável que recebe um dos seguintes valores para a configuração de estado:
Valor Descrição const unsigned long LISTEN_STATUS_CANLISTEN = 0; As condições oferecem suporte para entrada de fala. const unsigned long LISTEN_STATUS_NOAUDIO = 1; Não há dispositivo de entrada de áudio disponível neste sistema. (Isso não detecta se um microfone está instalado; ele só poderá detectar se o usuário tem uma placa de áudio habilitada para entrada instalada corretamente com um driver funcionando.) const unsigned long LISTEN_STATUS_NOTTOPMOST = 2; Outro cliente é o cliente ativo desse caractere, ou o caractere atual não está no topo. const unsigned long LISTEN_STATUS_CANTOPENAUDIO = 3; O canal de entrada ou saída de áudio está ocupado no momento, e algum outro aplicativo está usando o áudio. const unsigned long LISTEN_STATUS_COULDNTINITIALIZESPEECH = 4; Ocorreu um erro não especificado no processo de inicialização do subsistema de reconhecimento de fala. Isso inclui a possibilidade de que não haja nenhum mecanismo de fala disponível correspondente à configuração de idioma do caractere. const unsigned long LISTEN_STATUS_SPEECHDISABLED = 5; O usuário desativou a entrada de fala na janela Opções Avançadas de Caracteres. const unsigned long LISTEN_STATUS_ERROR = 6; Ocorreu um erro na verificação do status do áudio, mas a causa do erro não foi retornada pelo sistema.
Essa função permite que você consulte se as condições atuais funcionam com a entrada de reconhecimento de fala, incluindo o status do dispositivo de áudio. Se o aplicativo usar o método IAgentCharacterEx::Listen, você poderá usar essa função para garantir melhor que a chamada seja bem-sucedida. Chamar esse método também carrega o mecanismo de fala, caso ainda não esteja carregado. No entanto, ele não ativa o modo de escuta.
Quando a entrada de fala estiver habilitada na folha de propriedades do Agente (Opções Avançadas de Caractere), a consulta de status carregará o mecanismo associado (se ele ainda não estiver carregado) e iniciará os serviços de fala. Ou seja, a tecla Listening está disponível, e a Listening Tip poderá ser exibida. (A tecla Listening e a Listening Tip serão ativadas somente se também estiverem ativadas nas Opções Avançadas de Caracteres.) No entanto, se você consultar a propriedade quando a fala estiver desabilitada, o servidor não iniciará os serviços de fala.
Essa função retorna apenas a configuração para o uso do caractere pelo aplicativo cliente; a configuração não reflete outros clientes do caractere ou outros caracteres do aplicativo cliente.