Método IXAudio2SourceVoice::GetState (xaudio2.h)

  • Artigo

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

Confira também

Como: Fazer o streaming de um som do disco

IXAudio2SourceVoice