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


IAgentCharacterEx::GetSRModeID

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

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

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

  • Возвращает S_OK, чтобы указать, что операция выполнена успешно.

pbszModeID

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

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

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

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

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

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

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

См. также

IAgentCharacterEx::SetSRModeID