XSpeechSynthesizerCreateStreamFromText
指定されたプレーン テキストから音声合成ストリームを作成します。Syntax
Parameters
speechSynthesizer _In_型: XSpeechSynthesizerHandle 使用する音声合成器。 text _In_z_
型: char* 音声を生成するために使用するプレーン テキスト。 speechSynthesisStream _Out_
型: XSpeechSynthesizerStreamHandle* text で指定されたプレーン テキストから生成された音声を表す音声合成ストリーム。
Return value
型: HRESULT 成功した場合は S_OK を返します。そうでない場合はエラー コードを返します。エラー コードの一覧については、エラー コード を参照してください。音声合成器ストリームが最大データ サイズより大きいために関数が失敗した場合、戻り値は E_BOUNDS に設定されます。Remarks
この関数はタイム センシティブ スレッドで呼び出すのは安全ではありません。詳細については、タイム センシティブ スレッド を参照してください。
-
この関数を使用して、プレーン テキストから音声を合成し、WAVE コンテナー (
audio/wavMIME タイプ) 形式でオーディオ データを生成します。この関数を使用して音声合成器ストリームを作成し、プレーン テキストから音声を合成した後、XSpeechSynthesizerGetStreamDataSize および XSpeechSynthesizerGetStreamData 関数を使用して、音声合成器ストリームからオーディオ データを取得します。オーディオ データを取得した後、XSpeechSynthesizerCloseStreamHandle 関数を使用して音声合成器ストリームを閉じます。 - 音声合成器ストリームの最大データ サイズは 0xffffffff バイト、つまり 4 ギガバイトから 1 バイトを引いたサイズです。最大データ サイズより大きい音声合成器ストリームを作成しようとするとエラーが発生します。
- メモリ リークを防ぐため、ハンドルを使用するすべての操作が完了した後、XSpeechSynthesizerCloseStreamHandle 関数を呼び出して音声合成器ストリーム ハンドルを閉じてください。この関数を呼び出す前に、未完了の非同期操作をすべて完了させておく必要があります。
- XSpeechSynthesizerCreateStreamFromText 関数の使用方法を示す例については、XSpeechSynthesizerCreate を参照してください。
Requirements
ヘッダー: XSpeechSynthesizer.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体Conceptual documentation
See also
XAccessibilityXSpeechSynthesizerCloseStreamHandle
XSpeechSynthesizer
