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

Artigo
08/28/2023

Inicia o consumo e o processamento de áudio pela voz. Fornece o resultado para qualquer submixagem conectada ou vozes de masterização ou para o dispositivo de saída.

Sintaxe

HRESULT Start(
  [in] UINT32 Flags,
  [in] UINT32 OperationSet
);

Parâmetros

[in] Flags

Sinalizadores que controlam como a voz é iniciada. Deve ser 0.

[in] OperationSet

Identifica essa chamada como parte de um lote adiado. Consulte a Visão geral dos Conjuntos de Operações XAudio2 para obter mais informações.

Valor retornado

Retorna S_OK se tiver êxito, caso contrário, um código de erro. Consulte Códigos de erro XAudio2 para obter descrições de códigos de erro específicos do XAudio2.

Comentários

Se o mecanismo XAudio2 for interrompido, a voz deixará de ser executada. No entanto, ele permanece no estado iniciado, para que ele comece a ser executado novamente assim que o mecanismo for iniciado.

Quando criadas pela primeira vez, as vozes de origem estão no estado parado. As vozes de submixagem e masterização estão no estado iniciado.

Depois que Start for chamado, ele não terá mais efeito se for chamado novamente antes de IXAudio2SourceVoice::Stop ser chamado. Além disso, várias chamadas para Iniciar sem chamadas correspondentes a IXAudio2SourceVoice::Stop resultarão em mensagens de aviso em builds de depuração.