Share via

Método IAudioClient::Start (audioclient.h)

  • Artigo

O método Start inicia o fluxo de áudio.

Sintaxe

HRESULT Start();

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno Descrição
AUDCLNT_E_NOT_INITIALIZED
 O fluxo de áudio não foi inicializado com êxito.
AUDCLNT_E_NOT_STOPPED
 O fluxo de áudio não foi interrompido no momento da chamada iniciar .
AUDCLNT_E_EVENTHANDLE_NOT_SET
 O fluxo de áudio é configurado para usar o buffer controlado por eventos, mas o chamador não chamou IAudioClient::SetEventHandle para definir o identificador de evento no fluxo.
AUDCLNT_E_DEVICE_INVALIDATED
 O dispositivo de ponto de extremidade de áudio foi desconectado ou o hardware de áudio ou os recursos de hardware associados foram reconfigurados, desabilitados, removidos ou não estão disponíveis para uso.
AUDCLNT_E_SERVICE_NOT_RUNNING
 O serviço de áudio do Windows não está em execução.

Comentários

Esse método requer a inicialização prévia da interface IAudioClient . Todas as chamadas para esse método falharão com o erro AUDCLNT_E_NOT_INITIALIZED até que o cliente inicialize o fluxo de áudio chamando com êxito o método IAudioClient::Initialize .

Start é um método de controle que o cliente chama para iniciar o fluxo de áudio. Iniciar o fluxo faz com que o objeto IAudioClient inicie o streaming de dados entre o buffer do ponto de extremidade e o mecanismo de áudio. Ele também faz com que o relógio de áudio do fluxo retome a contagem de sua posição atual.

Na primeira vez que esse método é chamado após a inicialização do fluxo, o contador de posição de fluxo do objeto IAudioClient começa em 0. Caso contrário, o relógio retomará de sua posição no momento em que o fluxo foi interrompido pela última vez. Redefinir o fluxo força a posição do fluxo de volta para 0.

Para evitar falhas de inicialização com fluxos de renderização, os clientes não devem chamar Iniciar até que o mecanismo de áudio tenha sido inicialmente carregado com dados chamando os métodos IAudioRenderClient::GetBuffer e IAudioRenderClient::ReleaseBuffer na interface de renderização.

Para obter exemplos de código que chamam o método Start , consulte os seguintes tópicos:

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho audioclient.h

Confira também

IAudioClient Interface

IAudioClient::Initialize

IAudioRenderClient::GetBuffer

IAudioRenderClient::ReleaseBuffer