> ## 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](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerenumerateinstalledvoices)가 호출될 때 음성에 대한 정보를 받는 클라이언트 구현 콜백 함수입니다.

## 구문

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

### 매개 변수

*information*   \_In\_\
형식: [XSpeechSynthesizerVoiceInformation\*](/reference/system/xspeechsynthesizer/structs/xspeechsynthesizervoiceinformation)

현재 열거된 음성의 세부 정보를 포함하는 [XSpeechSynthesizerVoiceInformation](/reference/system/xspeechsynthesizer/structs/xspeechsynthesizervoiceinformation) 구조체에 대한 포인터입니다.

*context*   \_In\_\
형식: void\*

[XSpeechSynthesizerEnumerateInstalledVoices](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerenumerateinstalledvoices)에 대한 초기 호출에서 제공된 컨텍스트 포인터입니다.

### 반환 값

형식: bool

[XSpeechSynthesizerEnumerateInstalledVoices](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerenumerateinstalledvoices)가 열거를 계속하려면 **true**를 반환하고, [XSpeechSynthesizerEnumerateInstalledVoices](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerenumerateinstalledvoices)가 열거를 중지하려면 **false**를 반환합니다.

## 설명

* **XSpeechSynthesizerInstalledVoicesCallback** 함수가 **true**를 반환하는 동안, **XSpeechSynthesizerInstalledVoicesCallback** 콜백 함수는 설치된 각 음성 합성 엔진(*음성*)에 대해 [XSpeechSynthesizerEnumerateInstalledVoices](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerenumerateinstalledvoices)에 의해 한 번씩 호출됩니다. **XSpeechSynthesizerInstalledVoicesCallback** 함수가 **false**를 반환하면 **XSpeechSynthesizerEnumerateInstalledVoices**는 나머지 설치된 음성에 대한 열거를 중지합니다.

* 현재 디바이스에 설치된 각 음성에 대한 정보를 식별하고 표시하려면 *information*의 [XSpeechSynthesizerVoiceInformation](/reference/system/xspeechsynthesizer/structs/xspeechsynthesizervoiceinformation) 구조체에서 제공되는 데이터를 사용합니다.

* **XSpeechSynthesizerInstalledVoicesCallback** 콜백 함수를 사용하는 방법을 보여 주는 예제는 [XSpeechSynthesizerEnumerateInstalledVoices](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerenumerateinstalledvoices)를 참조하세요.

## 요구 사항

**헤더:** XSpeechSynthesizer.h

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 참고 항목

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


## Related topics

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