XSpeechSynthesizerCreateStreamFromText
從指定的純文字建立語音合成資料流。語法
參數
speechSynthesizer _In_類型:XSpeechSynthesizerHandle 要使用的語音合成器。 text _In_z_
類型:char* 要從中產生語音的純文字。 speechSynthesisStream _Out_
類型:XSpeechSynthesizerStreamHandle* 語音合成資料流,代表從 text 中指定之純文字所產生的語音。
傳回值
類型:HRESULT 如果成功,則傳回 S_OK;否則傳回錯誤碼。如需錯誤碼的清單,請參閱錯誤碼。如果函式因語音合成器資料流大於資料大小上限而失敗,傳回值會設為 E_BOUNDS。備註
在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
-
使用此函式從純文字合成語音,並產生 WAVE 容器 (
audio/wavMIME 類型) 格式的音訊資料。使用此函式建立語音合成器資料流並從純文字合成語音之後,請使用 XSpeechSynthesizerGetStreamDataSize 和 XSpeechSynthesizerGetStreamData 函式,從語音合成器資料流擷取音訊資料。擷取音訊資料之後,請使用 XSpeechSynthesizerCloseStreamHandle 函式關閉語音合成器資料流。 - 語音合成器資料流的資料大小上限為 0xffffffff 位元組:4 GB 減去 1 位元組。如果您嘗試建立大於資料大小上限的語音合成器資料流,就會發生錯誤。
- 若要防止記憶體流失,請在完成所有使用語音合成器資料流控制代碼的作業之後,呼叫 XSpeechSynthesizerCloseStreamHandle 函式來關閉該控制代碼。在呼叫此函式之前,必須完成所有未完成的非同步作業。
- 如需示範如何使用 XSpeechSynthesizerCreateStreamFromText 函式的範例,請參閱 XSpeechSynthesizerCreate。
需求
標頭: XSpeechSynthesizer.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機概念文件
另請參閱
XAccessibilityXSpeechSynthesizerCloseStreamHandle
XSpeechSynthesizer
