Поделиться через

IAgentCharacterEx::GetSRModeID

  • Статья

[Агент Майкрософт не рекомендуется использовать в Windows 7 и может быть недоступен в последующих версиях Windows.]

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

Извлекает идентификатор режима обработчика распознавания речи, заданного для символа.

  • Возвращает S_OK для указания успешной операции.

pbszModeID

Адрес BSTR, который получает параметр идентификатора режима обработчика распознавания речи для символа.

Этот параметр возвращает набор обработчика для голосового ввода символа. Идентификатор режима для подсистемы распознавания речи — это строковое представление GUID (в формате фигурных скобок и дефисов) поставщиком речи, уникальным образом идентифицируя подсистему. Дополнительные сведения см. в документации по пакету SDK службы "Речь Майкрософт".

Если не задать идентификатор режима обработчика распознавания речи для символа, сервер возвращает обработчик, соответствующий языковым параметрам символа (с помощью интерфейсов API распознавания речи Майкрософт). Если для символа отсутствует соответствующий механизм распознавания речи, сервер возвращает строку null (пустую).

Если речевой ввод включен (в окне Расширенные параметры символов), запрос или задание этого свойства загрузит связанный модуль (если он еще не загружен) и запустит службы распознавания речи. Это значит, что доступна клавиша прослушивания и отображается подсказка прослушивания. (Клавиша прослушивания и подсказка для прослушивания включены только в том случае, если они также включены в расширенных параметрах символов.) Однако при запросе к свойству при отключении речи сервер не запускает службы распознавания речи и возвращает пустую строку (пустую строку).

Эта функция возвращает только параметр для использования символа в клиентском приложении; параметр не отражает другие клиенты символа или другие символы клиентского приложения.

Эта функция не завершается ошибкой, если функция IAgentSpeechInputProperties::GetEnabled возвращает значение False.

Требования к подсистеме распознавания речи Microsoft Agent основаны на API службы "Речь Майкрософт". Подсистемы, поддерживающие требования MICROSOFT Agent к SAPI, можно установить и использовать с агентом.

См. также:

IAgentCharacterEx::SetSRModeID