Compartilhar via

IAgentCharacterEx::GetSRModeID

  • Artigo

[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]

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

Recupera a ID do modo do mecanismo de reconhecimento de fala definido para o caractere.

  • Retorna S_OK para indicar que a operação foi bem-sucedida.

pbszModeID

Endereço de um BSTR que recebe a configuração de ID de modo do mecanismo de reconhecimento de fala para o caractere.

Essa configuração retorna o conjunto de mecanismos para a entrada de fala de um caractere. A ID do modo de um mecanismo de reconhecimento de fala é uma representação de cadeia de caracteres do GUID (formatada com chaves e traços) pelo fornecedor de fala que identifica exclusivamente o mecanismo. Para obter mais informações, consulte a documentação do SDK de Fala da Microsoft.

Se você não definir uma ID de modo de mecanismo de reconhecimento de fala para o caractere, o servidor retornará um mecanismo que corresponda à configuração de idioma do caractere (usando interfaces da API de Fala da Microsoft). Se não houver nenhum mecanismo de reconhecimento de fala correspondente disponível para o caractere, o servidor retornará uma cadeia de caracteres nula (vazia).

Quando a entrada de fala estiver habilitada (na janela Opções avançadas de caractere), a consulta ou a configuração dessa propriedade carregará o mecanismo associado (se ainda não estiver carregado) e iniciará os serviços de fala. Ou seja, a tecla Listening está disponível e a Dica de Escuta pode ser exibida. (A tecla Listening e a Dica de Escuta serão habilitadas somente se elas também estiverem habilitadas em 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 e retornará uma cadeia de caracteres nula (cadeia de caracteres vazia).

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.

Essa função não falhará se IAgentSpeechInputProperties::GetEnabled retornar False.

Os requisitos do mecanismo de fala do Microsoft Agent são baseados na API de Fala da Microsoft. Mecanismos que dão suporte aos requisitos de SAPI do Microsoft Agent podem ser instalados e usados com o Agent.

Consulte Também

IAgentCharacterEx::SetSRModeID