IAgentCharacterEx：：GetTTSModeID

[Microsoft 代理从 Windows 7 开始已弃用，可能在后续版本的 Windows 中不可用。]

HRESULT GetTTSModeID(
   BSTR * pbszModeID  // address of TTS engine ID
);

检索字符的 TTS 引擎集的模式 ID。

• 返回指示操作成功的S_OK。

pbszModeID

接收字符 TTS 引擎的模式 ID 设置的 BSTR 的地址。

此设置返回 TTS (文本转语音) 角色的语音输出的引擎模式 ID。 TTS 引擎的模式 ID 是 GUID (格式的字符串表示形式，由唯一标识引擎的语音供应商定义) 大括号和短划线。 有关详细信息，请参阅 Microsoft 语音 SDK 文档。 查询此属性将加载关联的引擎（如果尚未加载）。

如果未为字符设置 TTS 引擎模式 ID，服务器会尝试使用 Microsoft 语音 API 接口返回与 (匹配的引擎，) 字符的已编译 TTS 设置和字符的当前语言设置。 如果这些设置不同，则字符的语言设置将覆盖其创作模式设置。 如果尚未设置字符的语言设置，则字符的语言是用户默认语言 ID，服务器会基于该语言 ID 尝试匹配。

如果 IAgentAudioObjectProperties：：GetEnabled 返回 False，则此函数不会失败。

此属性仅适用于客户端应用程序对 字符的使用;设置不会影响客户端应用程序的字符或其他字符的其他客户端。

Microsoft 代理的语音引擎要求基于 Microsoft 语音 API。 支持 Microsoft 代理 SAPI 要求的引擎可以与代理一起安装并使用。

另请参阅

IAgentCharacterEx：：SetTTSModeID