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

  • Artigo

O método Reset redefine o fluxo de áudio.

Sintaxe

HRESULT Reset();

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se o método for bem-sucedido e o fluxo já tiver sido redefinido, 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 fluxo de áudio não foi inicializado com êxito.
AUDCLNT_E_NOT_STOPPED
 O fluxo de áudio não foi interrompido no momento em que a chamada foi feita.
AUDCLNT_E_BUFFER_OPERATION_PENDING
 No momento, o cliente está gravando ou lendo do buffer.
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 anterior 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 .

Reset é um método de controle que o cliente chama para redefinir um fluxo de áudio interrompido. A redefinição do fluxo libera todos os dados pendentes e redefine a posição do fluxo do relógio de áudio para 0. Esse método falhará se for chamado em um fluxo que não é interrompido.

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