Skip to main content

XSpeechSynthesizerCreateStreamFromText

指定されたプレーン テキストから音声合成ストリームを作成します。

Syntax

Parameters

speechSynthesizer   _In_
型: XSpeechSynthesizerHandle
使用する音声合成器。 text   _In_z_
型: char*
音声を生成するために使用するプレーン テキスト。 speechSynthesisStream   _Out_
型: XSpeechSynthesizerStreamHandle*
text で指定されたプレーン テキストから生成された音声を表す音声合成ストリーム。

Return value

型: HRESULT 成功した場合は S_OK を返します。そうでない場合はエラー コードを返します。エラー コードの一覧については、エラー コード を参照してください。音声合成器ストリームが最大データ サイズより大きいために関数が失敗した場合、戻り値は E_BOUNDS に設定されます。

Remarks

この関数はタイム センシティブ スレッドで呼び出すのは安全ではありません。詳細については、タイム センシティブ スレッド を参照してください。
  • この関数を使用して、プレーン テキストから音声を合成し、WAVE コンテナー (audio/wav MIME タイプ) 形式でオーディオ データを生成します。この関数を使用して音声合成器ストリームを作成し、プレーン テキストから音声を合成した後、XSpeechSynthesizerGetStreamDataSize および XSpeechSynthesizerGetStreamData 関数を使用して、音声合成器ストリームからオーディオ データを取得します。オーディオ データを取得した後、XSpeechSynthesizerCloseStreamHandle 関数を使用して音声合成器ストリームを閉じます。
  • 音声合成器ストリームの最大データ サイズは 0xffffffff バイト、つまり 4 ギガバイトから 1 バイトを引いたサイズです。最大データ サイズより大きい音声合成器ストリームを作成しようとするとエラーが発生します。
  • メモリ リークを防ぐため、ハンドルを使用するすべての操作が完了した後、XSpeechSynthesizerCloseStreamHandle 関数を呼び出して音声合成器ストリーム ハンドルを閉じてください。この関数を呼び出す前に、未完了の非同期操作をすべて完了させておく必要があります。
  • XSpeechSynthesizerCreateStreamFromText 関数の使用方法を示す例については、XSpeechSynthesizerCreate を参照してください。

Requirements

ヘッダー: XSpeechSynthesizer.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体

Conceptual documentation

See also

XAccessibility
XSpeechSynthesizerCloseStreamHandle
XSpeechSynthesizer
最終更新日 2026年8月24日