Compartilhar via


Gerenciando Waveform-Audio gravação

[O recurso associado a esta página, Waveform Audio, é um recurso herdado. Ele foi substituído por WASAPI e Grafos de Áudio. WASAPI e Grafos de Áudio foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use WASAPI e Audio Graphs em vez de Waveform Audio, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

Depois de abrir um dispositivo de entrada waveform-audio, você pode começar a gravar dados waveform-audio. Os dados waveform-audio são gravados em buffers fornecidos pelo aplicativo especificados por uma estrutura WAVEHDR . Esses blocos de dados devem ser preparados antes de serem usados; para obter mais informações, consulte Blocos de Dados de Áudio.

O Windows fornece as seguintes funções para gerenciar a gravação de áudio de forma de onda.

Função Descrição
Waveinaddbuffer Envia um buffer para o driver do dispositivo para que ele possa ser preenchido com dados de áudio de forma de onda gravados.
Waveinreset Interrompe a gravação de áudio de forma de onda e marca todos os buffers pendentes conforme feito.
waveInStart Inicia a gravação de áudio de forma de onda.
waveInStop Interrompe a gravação de áudio de forma de onda.

 

Use a função waveInAddBuffer para enviar buffers para o driver do dispositivo. Como os buffers são preenchidos com dados de áudio de forma de onda gravados, o aplicativo é notificado com uma mensagem de janela, mensagem de retorno de chamada, mensagem de thread ou evento, dependendo do sinalizador especificado quando o dispositivo foi aberto.

Antes de começar a gravar usando waveInStart, você deve enviar pelo menos um buffer para o driver ou os dados de entrada podem ser perdidos.

Antes de fechar o dispositivo usando waveInClose, chame waveInReset para marcar todos os blocos de dados pendentes como sendo feitos.

Gravando áudio de forma de onda