Método IXAudio2VoiceCallback::OnBufferStart (xaudio2.h)

  • Artigo

Chamado quando a voz está prestes a começar a processar um novo buffer de áudio.

Sintaxe

void OnBufferStart(
  void *pBufferContext
);

Parâmetros

pBufferContext

Ponteiro de contexto atribuído ao membro pContext da estrutura XAUDIO2_BUFFER quando o buffer foi enviado.

Retornar valor

Nenhum

Comentários

pBufferContext é o ponteiro de contexto originalmente fornecido pelo membro pContext da estrutura XAUDIO2_BUFFER , que pode ser NULL.

OnBufferStart tem a garantia de ser chamado pouco antes do primeiro byte do buffer atual ser consumido. É apropriado usar esse retorno de chamada para alterações no estado de voz, como o seguinte.

  • Enviando um novo buffer para a voz
  • Ajustando os parâmetros de volume, tom e efeito da voz
  • Habilitar ou desabilitar um efeito na cadeia de efeitos da voz
Todas as ações listadas acima são síncronas quando executadas em um retorno de chamada XAudio2, portanto, as alterações entrarão em vigor imediatamente, afetando o buffer que está prestes a ser iniciado.

Também é seguro usar esse retorno de chamada para gravar dados de áudio diretamente no buffer, o que pode ser útil para cenários de streaming de baixa latência. No entanto, assim como acontece com todos os retornos de chamada XAudio2, nenhum trabalho deve ser feito que use uma quantidade significativa de tempo de processador ou possa bloquear a execução, incluindo leituras de rede ou disco síncrono.

Para obter informações sobre os métodos de interface IXAudio2VoiceCallback , consulte a seção Retornos de chamada XAudio2 .

Requisitos da 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: Usar retornos de chamadas de voz de origem

IXAudio2VoiceCallback

Retorno de chamadas XAudio2