Compartilhar via


Função waveOutUnprepareHeader (mmeapi.h)

A função waveOutUnprepareHeader limpa a preparação executada pela função waveOutPrepareHeader . Essa função deve ser chamada depois que o driver do dispositivo for concluído com um bloco de dados. Você deve chamar essa função antes de liberar o buffer.

Sintaxe

MMRESULT waveOutUnprepareHeader(
  HWAVEOUT  hwo,
  LPWAVEHDR pwh,
  UINT      cbwh
);

Parâmetros

hwo

Identificador para o dispositivo de saída waveform-audio.

pwh

Ponteiro para uma estrutura WAVEHDR que identifica o bloco de dados a ser limpo.

cbwh

Tamanho, em bytes, da estrutura WAVEHDR .

Valor retornado

Retorna MMSYSERR_NOERROR se tiver êxito ou um erro de outra forma. Os valores de erro possíveis incluem o seguinte.

Código de retorno Descrição
MMSYSERR_INVALHANDLE
O identificador de dispositivo especificado é inválido.
MMSYSERR_NODRIVER
Nenhum driver de dispositivo está presente.
MMSYSERR_NOMEM
Não é possível alocar ou bloquear memória.
WAVERR_STILLPLAYING
O bloco de dados apontado pelo parâmetro pwh ainda está na fila.

Comentários

Essa função complementa waveOutPrepareHeader. Você deve chamar essa função antes de liberar o buffer. Depois de passar um buffer para o driver de dispositivo com a função waveOutWrite , você deve aguardar até que o driver seja concluído com o buffer antes de chamar waveOutUnprepareHeader.

Despreparar um buffer que não foi preparado não tem efeito e a função retorna zero.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mmeapi.h (inclua Windows.h)
Biblioteca Winmm.lib
DLL Winmm.dll

Confira também

Áudio de forma de onda

Funções waveform