Compartilhar via


Interface IAudioCaptureClient (audioclient.h)

A interface IAudioCaptureClient permite que um cliente leia dados de entrada de um buffer de ponto de extremidade de captura. O cliente obtém uma referência à interface IAudioCaptureClient em um objeto de fluxo chamando o método IAudioClient::GetService com o parâmetro riid definido como REFIID IID_IAudioCaptureClient.

Os métodos nessa interface gerenciam a movimentação de pacotes de dados que contêm dados de captura. O comprimento de um pacote de dados é expresso como o número de quadros de áudio no pacote. O tamanho de um quadro de áudio é especificado pelo membro nBlockAlign da estrutura WAVEFORMATEX (ou WAVEFORMATEXTENSIBLE) que o cliente obtém chamando o método IAudioClient::GetMixFormat . O tamanho em bytes de um quadro de áudio é igual ao número de canais no fluxo multiplicado pelo tamanho de exemplo por canal. Por exemplo, o tamanho do quadro é de quatro bytes para um fluxo estéreo (2 canais) com amostras de 16 bits. Um pacote sempre contém um número integral de quadros de áudio.

Ao liberar uma instância de interface IAudioCaptureClient , o cliente deve chamar o método Release da instância do mesmo thread que a chamada para IAudioClient::GetService que criou o objeto.

Para obter um exemplo de código que usa a interface IAudioCaptureClient, consulte Capturando um Stream.

Herança

A interface IAudioCaptureClient herda da interface IUnknown . IAudioCaptureClient também tem estes tipos de membros:

Métodos

A interface IAudioCaptureClient tem esses métodos.

 
IAudioCaptureClient::GetBuffer

Recupera um ponteiro para o próximo pacote de dados disponível no buffer do ponto de extremidade de captura.
IAudioCaptureClient::GetNextPacketSize

O método GetNextPacketSize recupera o número de quadros no próximo pacote de dados no buffer do ponto de extremidade de captura.
IAudioCaptureClient::ReleaseBuffer

O método ReleaseBuffer libera o buffer.

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

IAudioClient::GetMixFormat

IAudioClient::GetService

WASAPI