Método IXAudio2SourceVoice::GetState (xaudio2.h)
Retorna os dados de posição atual do cursor da voz.
Sintaxe
void GetState(
XAUDIO2_VOICE_STATE *pVoiceState,
[optional] UINT32 Flags
);
Parâmetros
pVoiceState
Ponteiro para uma estrutura XAUDIO2_VOICE_STATE que contém o estado da voz.
[optional] Flags
Sinalizadores que controlam quais dados de estado de voz devem ser retornados. Os valores válidos são 0 ou XAUDIO2_VOICE_NOSAMPLESPLAYED. O valor padrão é 0. Se você especificar XAUDIO2_VOICE_NOSAMPLESPLAYED, GetState retornará apenas o estado do buffer, não o estado do sampler. GetState leva cerca de um terço do tempo para ser concluído quando você especifica XAUDIO2_VOICE_NOSAMPLESPLAYED.
Retornar valor
Nenhum
Comentários
Se um cliente precisar obter as posições correlacionadas de várias vozes (por exemplo, para saber exatamente qual amostra de uma determinada voz está sendo reproduzida quando uma determinada amostra de outra voz está sendo reproduzida), ele deve fazer chamadas GetState em um retorno de chamada do mecanismo XAudio2. Isso garante que nenhuma das vozes avance enquanto as chamadas estão sendo feitas. Consulte a visão geral de retornos de chamada XAudio2 para obter informações sobre como usar retornos de chamada XAudio2.
Observe que as versões do SDK do DirectX do XAUDIO2 não levam o parâmetro Flags para GetState.
Requisitos de plataforma
Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); SDK do DirectX (XAudio 2.7)Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | xaudio2.h |