> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XSpeechSynthesizerInstalledVoicesCallback

> XSpeechSynthesizerInstalledVoicesCallback

# XSpeechSynthesizerInstalledVoicesCallback

由用戶端實作的回呼函式，會在呼叫 [XSpeechSynthesizerEnumerateInstalledVoices](/zh-TW/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerenumerateinstalledvoices) 時接收語音的相關資訊。

## 語法

```cpp theme={null}
bool XSpeechSynthesizerInstalledVoicesCallback(  
         const XSpeechSynthesizerVoiceInformation* information,  
         void* context  
)  
```

### 參數

*information*   \_In\_\
類型：[XSpeechSynthesizerVoiceInformation\*](/zh-TW/reference/system/xspeechsynthesizer/structs/xspeechsynthesizervoiceinformation)

指向 [XSpeechSynthesizerVoiceInformation](/zh-TW/reference/system/xspeechsynthesizer/structs/xspeechsynthesizervoiceinformation) 結構的指標，其中包含目前列舉之語音的詳細資料。

*context*   \_In\_\
類型：void\*

在初次呼叫 [XSpeechSynthesizerEnumerateInstalledVoices](/zh-TW/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerenumerateinstalledvoices) 時所提供的內容指標。

### 傳回值

類型：bool

如果 [XSpeechSynthesizerEnumerateInstalledVoices](/zh-TW/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerenumerateinstalledvoices) 要繼續列舉，則傳回 **true**；如果 [XSpeechSynthesizerEnumerateInstalledVoices](/zh-TW/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerenumerateinstalledvoices) 要停止列舉，則傳回 **false**。

## 備註

* 只要 **XSpeechSynthesizerInstalledVoicesCallback** 函式傳回 **true**，[XSpeechSynthesizerEnumerateInstalledVoices](/zh-TW/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerenumerateinstalledvoices) 就會針對每個已安裝的語音合成引擎 (或稱「語音」) 各呼叫一次 **XSpeechSynthesizerInstalledVoicesCallback** 回呼函式。如果 **XSpeechSynthesizerInstalledVoicesCallback** 函式傳回 **false**，**XSpeechSynthesizerEnumerateInstalledVoices** 就會停止列舉其餘已安裝的語音。

* 若要識別並顯示目前裝置上所安裝之每個語音的相關資訊，請使用 *information* 中 [XSpeechSynthesizerVoiceInformation](/zh-TW/reference/system/xspeechsynthesizer/structs/xspeechsynthesizervoiceinformation) 結構所提供的資料。

* 如需示範如何使用 **XSpeechSynthesizerInstalledVoicesCallback** 回呼函式的範例，請參閱 [XSpeechSynthesizerEnumerateInstalledVoices](/zh-TW/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerenumerateinstalledvoices)。

## 需求

**標頭：** XSpeechSynthesizer.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[XAccessibility](/zh-TW/reference/system/xaccessibility/xaccessibility_members)\
[XSpeechSynthesizerSetCustomVoice](/zh-TW/reference/system/xspeechsynthesizer/functions/xspeechsynthesizersetcustomvoice)\
[XSpeechSynthesizer](/zh-TW/reference/system/xspeechsynthesizer/xspeechsynthesizer_members)


## Related topics

- [XSpeechSynthesizerEnumerateInstalledVoices](/zh-TW/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerenumerateinstalledvoices.md)
- [XSpeechSynthesizerVoiceGender](/zh-TW/reference/system/xspeechsynthesizer/enums/xspeechsynthesizervoicegender.md)
- [XSpeechSynthesizerSetCustomVoice](/zh-TW/reference/system/xspeechsynthesizer/functions/xspeechsynthesizersetcustomvoice.md)
- [XSpeechSynthesizerSetDefaultVoice](/zh-TW/reference/system/xspeechsynthesizer/functions/xspeechsynthesizersetdefaultvoice.md)
- [XSpeechSynthesizer](/zh-TW/reference/system/xspeechsynthesizer/xspeechsynthesizer_members.md)