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 |