Compartilhar via


Interface IAudioClient (audioclient.h)

A interface IAudioClient permite que um cliente crie e inicialize um fluxo de áudio entre um aplicativo de áudio e o mecanismo de áudio (para um fluxo de modo compartilhado) ou o buffer de hardware de um dispositivo de ponto de extremidade de áudio (para um fluxo de modo exclusivo). Um cliente obtém uma referência a uma interface IAudioClient para um dispositivo de ponto de extremidade de áudio seguindo estas etapas:

  1. Usando uma das técnicas descritas na Interface IMMDevice, obtenha uma referência à interface IMMDevice para um dispositivo de ponto de extremidade de áudio.
  2. Chame o método IMMDevice::Activate com iid de parâmetro definido como REFIID IID_IAudioClient.

O thread de aplicativo que usa essa interface deve ser inicializado para COM. Para obter mais informações sobre a inicialização COM, consulte a descrição da função CoInitializeEx na documentação do SDK do Windows.

Para obter exemplos de código que usam a interface IAudioClient , consulte os seguintes tópicos:

Herança

A interface IAudioClient herda da interface IUnknown . O IAudioClient também tem esses tipos de membros:

Métodos

A interface IAudioClient tem esses métodos.

 
IAudioClient::GetBufferSize

O método GetBufferSize recupera o tamanho (capacidade máxima) do buffer do ponto de extremidade.
IAudioClient::GetCurrentPadding

O método GetCurrentPadding recupera o número de quadros de preenchimento no buffer do ponto de extremidade.
IAudioClient::GetDevicePeriod

O método GetDevicePeriod recupera o comprimento do intervalo periódico que separa o processamento sucessivo passa pelo mecanismo de áudio nos dados no buffer do ponto de extremidade.
IAudioClient::GetMixFormat

O método GetMixFormat recupera o formato de fluxo que o mecanismo de áudio usa para o processamento interno de fluxos de modo compartilhado.
IAudioClient::GetService

O método GetService acessa serviços adicionais do objeto cliente de áudio.
IAudioClient::GetStreamLatency

O método GetStreamLatency recupera a latência máxima para o fluxo atual e pode ser chamado a qualquer momento após a inicialização do fluxo.
IAudioClient::Initialize

O método Initialize inicializa o fluxo de áudio.
IAudioClient::IsFormatSupported

O método IsFormatSupported indica se o dispositivo de ponto de extremidade de áudio dá suporte a um formato de fluxo específico.
IAudioClient::Reset

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

O método SetEventHandle define o identificador de evento que o sistema sinaliza quando um buffer de áudio está pronto para ser processado pelo cliente.
IAudioClient::Start

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

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

Comentários

Nota Em Windows 8, o primeiro uso de IAudioClient para acessar o dispositivo de áudio deve estar no thread STA. Chamadas de um thread MTA podem resultar em um comportamento indefinido.
 

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

Principais interfaces de áudio

IMMDevice::Activate

WASAPI