Share via

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

  • Artigo

O método Stop interrompe o fluxo de áudio.

Sintaxe

HRESULT Stop();

Retornar valor

Se o método for bem-sucedido e interromper o fluxo, ele retornará S_OK. Se o método for bem-sucedido e o fluxo já tiver sido interrompido, o método retornará S_FALSE. 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 cliente não foi inicializado com êxito.
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 .

Stop é um método de controle que interrompe um fluxo de áudio em execução. Esse método impede que os dados sejam transmitidos por meio da conexão do cliente com o mecanismo de áudio. Parar o fluxo congela o relógio de áudio do fluxo em sua posição de fluxo atual. Uma chamada subsequente para IAudioClient::Start faz com que o fluxo retome a execução dessa posição. Se necessário, o cliente pode chamar o método IAudioClient::Reset para redefinir a posição enquanto o fluxo é interrompido.

Para obter exemplos de código que chamam o método Stop , 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

IAudioClient::Reset

IAudioClient::Start