> ## 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.

# XSpeechSynthesizerGetStreamDataSize

> XSpeechSynthesizerGetStreamDataSize

# XSpeechSynthesizerGetStreamDataSize

음성 합성 스트림에서 데이터 버퍼의 크기를 가져옵니다.

## 구문

```cpp theme={null}
HRESULT XSpeechSynthesizerGetStreamDataSize(  
         XSpeechSynthesizerStreamHandle speechSynthesisStream,  
         size_t* bufferSize  
)  
```

### 매개 변수

*speechSynthesisStream*   \_In\_\
형식: XSpeechSynthesizerStreamHandle

스트림 데이터를 포함하는 음성 합성기 스트림입니다.

*bufferSize*   \_Out\_\
형식: size\_t\*

스트림 데이터 버퍼의 크기(바이트)입니다.

### 반환 값

형식: [HRESULT](https://learn.microsoft.com/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

성공하면 **S\_OK**를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 [오류 코드](/reference/errorcodes)를 참조하세요.

## 설명

<Note>이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 [Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)를 참조하세요.</Note>

* [XSpeechSynthesizerCreateStreamFromText](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizercreatestreamfromtext) 함수를 호출하여 만든 음성 합성기 스트림의 데이터 버퍼에서 합성된 음성의 오디오 데이터를 검색하는 데 필요한 버퍼 크기를 확인하려면 이 함수를 사용합니다. 버퍼의 최대 데이터 크기는 0xffffffff 바이트(4기가바이트에서 1바이트를 뺀 값)입니다.

* 음성 합성기 스트림에서 오디오 데이터를 검색하려면 이 함수의 값을 사용하여 [XSpeechSynthesizerGetStreamData](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizergetstreamdata) 함수의 *bufferSize* 매개 변수 값을 설정합니다.

* **XSpeechSynthesizerGetStreamDataSize** 함수를 사용하는 방법을 보여 주는 예제는 [XSpeechSynthesizerCreate](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizercreate)를 참조하세요.

## 요구 사항

**헤더:** XSpeechSynthesizer.h

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

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

## 개념 설명서

* [Text-to-speech](/build/console-features/text-to-speech/text-to-speech)
* [Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 참고 항목

[XSpeechSynthesizerCreateStreamFromText](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizercreatestreamfromtext)\
[XSpeechSynthesizerGetStreamData](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizergetstreamdata)\
[XSpeechSynthesizer](/reference/system/xspeechsynthesizer/xspeechsynthesizer_members)


## Related topics

- [XSpeechSynthesizerGetStreamData](/ko/reference/system/xspeechsynthesizer/functions/xspeechsynthesizergetstreamdata.md)
- [텍스트 음성 변환](/ko/build/console-features/text-to-speech/text-to-speech.md)
- [XSpeechSynthesizer](/ko/reference/system/xspeechsynthesizer/xspeechsynthesizer_members.md)
- [XSpeechSynthesizerCreate](/ko/reference/system/xspeechsynthesizer/functions/xspeechsynthesizercreate.md)
- [XSpeechSynthesizerCreateStreamFromSsml](/ko/reference/system/xspeechsynthesizer/functions/xspeechsynthesizercreatestreamfromssml.md)