Skip to main content

XSpeechSynthesizerEnumerateInstalledVoices

枚举已安装的语音,并针对每个语音调用由 callback 指向的方法。

语法

参数

context   _In_opt_
类型:void*
一个用户指定的变量,将传入回调函数以使调用方能够恢复调用方特定的数据。 callback   _In_
类型:XSpeechSynthesizerInstalledVoicesCallback*
指向每个已安装语音将调用一次的方法的指针。

返回值

类型:HRESULT 如果成功,则返回 S_OK;否则返回错误代码。有关错误代码列表,请参阅错误代码

备注

此函数在时间敏感型线程上调用不安全。有关详细信息,请参阅时间敏感型线程
此函数枚举设备上安装的语音合成引擎,即语音。该函数针对每个已安装的语音调用一次在 callback 中指定的 XSpeechSynthesizerInstalledVoicesCallback 回调函数,并传递一个包含该语音信息的 XSpeechSynthesizerVoiceInformation 结构。 以下示例演示如何调用 XSpeechSynthesizerEnumerateInstalledVoices 函数来枚举设备上已安装的语音。该示例调用 XSpeechSynthesizerInstalledVoicesCallback 回调函数,以 (1) 计算设备上已安装的语音数量,并 (2) 将 XSpeechSynthesizerVoiceInformation 结构中每个已安装语音的信息输出到调试器。

要求

头文件: XSpeechSynthesizer.h 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

概念文档

另请参阅

XAccessibility
XSpeechSynthesizerSetCustomVoice
XSpeechSynthesizer
最后修改于 2026年8月24日