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 |