Compartilhar via

Função waveOutPrepareHeader (mmeapi.h)

  • Artigo

A função waveOutPrepareHeader prepara um bloco de dados de áudio de forma de onda para reprodução.

Sintaxe

MMRESULT waveOutPrepareHeader(
  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 preparado.

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.

Comentários

Defina os membros lpData, dwBufferLength e dwFlags da estrutura WAVEHDR antes de chamar essa função. Defina o membro dwFlags como zero.

Os membros dwFlags, dwBufferLength e dwLoops da estrutura WAVEHDR podem ser alterados entre chamadas para essa função e a função waveOutWrite . Se você alterar o tamanho especificado por dwBufferLength antes da chamada para waveOutWrite, o novo valor deverá ser menor que o valor preparado.

Se o método for bem-sucedido, o sinalizador WHDR_PREPARED será definido no membro dwFlags da estrutura WAVEHDR .

Preparar um cabeçalho que já 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 Mmeapi.h, Windows.h)
Biblioteca Winmm.lib
DLL Winmm.dll

Confira também

Áudio de forma de onda

Funções waveform