Método IXAudio2SourceVoice::D iscontinuity (xaudio2.h)

  • Artigo

Notifica uma voz XAudio2 de que não há mais buffers vindo após o último que está atualmente em sua fila.

Sintaxe

HRESULT Discontinuity();

Retornar valor

Retorna S_OK se tiver êxito, caso contrário, um código de erro.

Comentários

A descontinuidade suprime os avisos que normalmente ocorrem no build de depuração do XAudio2 quando uma voz fica sem buffers de áudio para ser reproduzida. É preferível marcar o buffer final de um fluxo marcando-o com o sinalizador XAUDIO2_END_OF_STREAM, mas em alguns casos o cliente pode não saber que um buffer é o fim de um fluxo até que o buffer tenha sido enviado.

Como chamar Descontinuidade é equivalente à aplicação do sinalizador XAUDIO2_END_OF_STREAM retroativamente ao último buffer enviado, um retorno de chamada OnStreamEnd será feito quando esse buffer for concluído.

Nota O XAudio2 pode consumir toda a fila de buffers e emitir um aviso antes que a chamada de descontinuidade entre em vigor, portanto, não há garantia de que a descontinuidade suprima os avisos.
 

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

IXAudio2SourceVoice