Skip to main content

XSpeechSynthesizerInstalledVoicesCallback

XSpeechSynthesizerEnumerateInstalledVoices가 호출될 때 음성에 대한 정보를 받는 클라이언트 구현 콜백 함수입니다.

구문

매개 변수

information   _In_
형식: XSpeechSynthesizerVoiceInformation*
현재 열거된 음성의 세부 정보를 포함하는 XSpeechSynthesizerVoiceInformation 구조체에 대한 포인터입니다. context   _In_
형식: void*
XSpeechSynthesizerEnumerateInstalledVoices에 대한 초기 호출에서 제공된 컨텍스트 포인터입니다.

반환 값

형식: bool XSpeechSynthesizerEnumerateInstalledVoices가 열거를 계속하려면 true를 반환하고, XSpeechSynthesizerEnumerateInstalledVoices가 열거를 중지하려면 false를 반환합니다.

설명

  • XSpeechSynthesizerInstalledVoicesCallback 함수가 true를 반환하는 동안, XSpeechSynthesizerInstalledVoicesCallback 콜백 함수는 설치된 각 음성 합성 엔진(음성)에 대해 XSpeechSynthesizerEnumerateInstalledVoices에 의해 한 번씩 호출됩니다. XSpeechSynthesizerInstalledVoicesCallback 함수가 false를 반환하면 XSpeechSynthesizerEnumerateInstalledVoices는 나머지 설치된 음성에 대한 열거를 중지합니다.
  • 현재 디바이스에 설치된 각 음성에 대한 정보를 식별하고 표시하려면 informationXSpeechSynthesizerVoiceInformation 구조체에서 제공되는 데이터를 사용합니다.
  • XSpeechSynthesizerInstalledVoicesCallback 콜백 함수를 사용하는 방법을 보여 주는 예제는 XSpeechSynthesizerEnumerateInstalledVoices를 참조하세요.

요구 사항

헤더: XSpeechSynthesizer.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

참고 항목

XAccessibility
XSpeechSynthesizerSetCustomVoice
XSpeechSynthesizer
마지막 수정일 2026년 8월 24일