Compartilhar via

Interface IAudioClient (audioclient.h)

  • Artigo

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 em de 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 o parâmetro iid definido como REFIID IID_IAudioClient. A partir do Windows 10, os chamadores do Windows 10 Build 20348 podem passar uma AUDIOCLIENT_ACTIVATION_PARAMS para configurar o IAudioClient para captura de loopback com um filtro de processo.

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 de IAudioClient , consulte os seguintes tópicos:

Herança

A interface IAudioClient herda da interface IUnknown . IAudioClient também tem estes 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 de 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 as sucessivas passagens de processamento 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.

Observações

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

Requisitos

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

Consulte também

principais interfaces de áudio

IMMDevice::Activate

WASAPI