IXAudio2SourceVoice::GetState 方法 (xaudio2.h)

返回语音的当前光标位置数据。

语法

void GetState(
             XAUDIO2_VOICE_STATE *pVoiceState,
  [optional] UINT32              Flags
);

参数

pVoiceState

指向包含语音状态 的XAUDIO2_VOICE_STATE 结构的指针。

[optional] Flags

控制应返回哪些语音状态数据的标志。 有效值为 0 或 XAUDIO2_VOICE_NOSAMPLESPLAYED。 默认值为 0。 如果指定 XAUDIO2_VOICE_NOSAMPLESPLAYED则 GetState 仅返回缓冲区状态,而不返回采样器状态。 指定XAUDIO2_VOICE_NOSAMPLESPLAYED,GetState 大约需要三分之一的时间来完成。

返回值

备注

例如,如果客户端需要获取多个语音的相关位置 (,若要确切地知道当另一个语音的给定样本正在播放) 时,它必须在 XAudio2 引擎回调中发出 GetState 调用。 这可确保在进行呼叫时不会发出任何声音。 有关使用 XAudio2 回调 的信息,请参阅 XAudio2 回调概述。

请注意,XAUDIO2的 DirectX SDK 版本不采用 GetState 的 Flags 参数。

平台要求

Windows 10 (XAudio2.9) ;Windows 8,Windows Phone 8 (XAudio 2.8) ;DirectX SDK (XAudio 2.7)

要求

要求
目标平台 Windows
标头 xaudio2.h

另请参阅

如何:对磁盘中的声音进行流式处理

IXAudio2SourceVoice