Skip to main content

XSpeechSynthesizerCreateStreamFromText

從指定的純文字建立語音合成資料流。

語法

參數

speechSynthesizer   _In_
類型:XSpeechSynthesizerHandle
要使用的語音合成器。 text   _In_z_
類型:char*
要從中產生語音的純文字。 speechSynthesisStream   _Out_
類型:XSpeechSynthesizerStreamHandle*
語音合成資料流,代表從 text 中指定之純文字所產生的語音。

傳回值

類型:HRESULT 如果成功,則傳回 S_OK;否則傳回錯誤碼。如需錯誤碼的清單,請參閱錯誤碼。如果函式因語音合成器資料流大於資料大小上限而失敗,傳回值會設為 E_BOUNDS。

備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
  • 使用此函式從純文字合成語音,並產生 WAVE 容器 (audio/wav MIME 類型) 格式的音訊資料。使用此函式建立語音合成器資料流並從純文字合成語音之後,請使用 XSpeechSynthesizerGetStreamDataSize 和 XSpeechSynthesizerGetStreamData 函式,從語音合成器資料流擷取音訊資料。擷取音訊資料之後,請使用 XSpeechSynthesizerCloseStreamHandle 函式關閉語音合成器資料流。
  • 語音合成器資料流的資料大小上限為 0xffffffff 位元組:4 GB 減去 1 位元組。如果您嘗試建立大於資料大小上限的語音合成器資料流,就會發生錯誤。
  • 若要防止記憶體流失,請在完成所有使用語音合成器資料流控制代碼的作業之後,呼叫 XSpeechSynthesizerCloseStreamHandle 函式來關閉該控制代碼。在呼叫此函式之前,必須完成所有未完成的非同步作業。
  • 如需示範如何使用 XSpeechSynthesizerCreateStreamFromText 函式的範例,請參閱 XSpeechSynthesizerCreate。

需求

標頭: XSpeechSynthesizer.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XAccessibility
XSpeechSynthesizerCloseStreamHandle
XSpeechSynthesizer
Last modified on October 6, 2026