Skip to main content

XSpeechSynthesizerEnumerateInstalledVoices

설치된 음성을 열거하고 각 음성에 대해 callback이 가리키는 메서드를 호출합니다.

구문

매개 변수

context   _In_opt_
형식: void*
호출자가 호출자 관련 데이터를 복구할 수 있도록 콜백 함수에 전달될 사용자 지정 변수입니다. callback   _In_
형식: XSpeechSynthesizerInstalledVoicesCallback*
설치된 각 음성에 대해 한 번씩 호출될 메서드에 대한 포인터입니다.

반환 값

형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 오류 코드를 참조하세요.

설명

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 Time-sensitive threads를 참조하세요.
이 함수는 디바이스에 설치된 음성 합성 엔진, 즉 음성을 열거합니다. 이 함수는 설치된 각 음성에 대해 한 번씩 callback에 지정된 XSpeechSynthesizerInstalledVoicesCallback 콜백 함수를 호출하고, 해당 음성에 대한 정보를 포함하는 XSpeechSynthesizerVoiceInformation 구조체를 전달합니다. 다음 예제는 XSpeechSynthesizerEnumerateInstalledVoices 함수를 호출하여 디바이스에 설치된 음성을 열거하는 방법을 보여 줍니다. 이 예제는 XSpeechSynthesizerInstalledVoicesCallback 콜백 함수를 호출하여 (1) 디바이스에 설치된 음성 수를 세고, (2) XSpeechSynthesizerVoiceInformation 구조체에서 설치된 각 음성에 대한 정보를 디버거로 출력합니다.

요구 사항

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

개념 설명서

참고 항목

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