XSpeechSynthesizerGetStreamData

从语音合成流检索数据。

语法

HRESULT XSpeechSynthesizerGetStreamData(  
         XSpeechSynthesizerStreamHandle speechSynthesisStream,  
         size_t bufferSize,  
         void* buffer,  
         size_t* bufferUsed  
)  

参数

speechSynthesisStream _In_
类型：XSpeechSynthesizerStreamHandle

包含数据缓冲区的语音合成流。

bufferSize _In_
类型：size_t

XSpeechSynthesizerGetStreamDataSize 返回的缓冲区大小（字节）。

buffer _Out_writes_to_(bufferSize,bufferUsed)
类型：void

一个指针，指向将接收数据的数据缓冲区。

bufferUsed _Out_opt_
类型：size_t*

buffer 中收到的数据的大小（字节）。

返回值

类型：HRESULT

如果成功，则返回 S_OK；否则返回错误代码。 有关错误代码的列表，请参阅错误代码。 如果此函数由于 speechSynthesisStream 未设置为有效的语音合成器流句柄而失败，则返回值设置为 HRESULT_FROM_WIN32(ERROR_NOT_FOUND)。

备注

注意

在时间敏感线程上调用此函数是不安全的。 有关详细信息，请参阅时间敏感线程。

使用此函数，从通过调用 XSpeechSynthesizerCreateStreamFromText 函数创建的语音合成器流的数据缓冲区中检索合成语音的音频数据。 音频数据以 WAVE 容器（audio/wav MIME 类型）格式返回。

有关演示如何使用 XSpeechSynthesizerGetStreamData 函数的示例，请参阅 XSpeechSynthesizerCreate。

要求

头文件：XSpeechSynthesizer.h

库：xgameruntime.lib

支持平台：Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

XAccessibility
XSpeechSynthesizerGetStreamDataSize
XSpeechSynthesizer