Skip to main content

XSpeechSynthesizerEnumerateInstalledVoices

インストールされている音声を列挙し、各音声について callback が指すメソッドを呼び出します。

Syntax

Parameters

context   _In_opt_
型: void*
呼び出し元固有のデータを回復できるよう、コールバック関数に渡されるユーザー指定の変数。 callback   _In_
型: XSpeechSynthesizerInstalledVoicesCallback*
インストールされている各音声に対して 1 回呼び出されるメソッドへのポインター。

Return value

型: HRESULT 成功した場合は S_OK を返します。そうでない場合はエラー コードを返します。エラー コードの一覧については、エラー コード を参照してください。

Remarks

この関数はタイム センシティブ スレッドで呼び出すのは安全ではありません。詳細については、タイム センシティブ スレッド を参照してください。
この関数は、デバイスにインストールされている音声合成エンジン (音声) を列挙します。この関数は、callback で指定された XSpeechSynthesizerInstalledVoicesCallback コールバック関数を、インストールされている音声ごとに 1 回呼び出し、その音声に関する情報を含む XSpeechSynthesizerVoiceInformation 構造体を渡します。 次の例は、XSpeechSynthesizerEnumerateInstalledVoices 関数を呼び出して、デバイス上にインストールされている音声を列挙する方法を示しています。この例は、XSpeechSynthesizerInstalledVoicesCallback コールバック関数を呼び出して、(1) デバイスにインストールされている音声の数を数え、(2) XSpeechSynthesizerVoiceInformation 構造体から、インストールされている各音声に関する情報をデバッガーに出力します。

Requirements

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

Conceptual documentation

See also

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