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
Last modified on October 6, 2026