Compartilhar via


Estrutura WAVEHDR (mmeapi.h)

A estrutura WAVEHDR define o cabeçalho usado para identificar um buffer de áudio de forma de onda.

Sintaxe

typedef struct wavehdr_tag {
  LPSTR              lpData;
  DWORD              dwBufferLength;
  DWORD              dwBytesRecorded;
  DWORD_PTR          dwUser;
  DWORD              dwFlags;
  DWORD              dwLoops;
  struct wavehdr_tag *lpNext;
  DWORD_PTR          reserved;
} WAVEHDR, *PWAVEHDR, *NPWAVEHDR, *LPWAVEHDR;

Membros

lpData

Ponteiro para o buffer de forma de onda.

dwBufferLength

Comprimento, em bytes, do buffer.

dwBytesRecorded

Quando o cabeçalho é usado na entrada, especifica a quantidade de dados no buffer.

dwUser

Dados do usuário.

dwFlags

Um OR bit a bit de zero ou mais sinalizadores. Os seguintes sinalizadores são definidos:

Nome Descrição
WHDR_BEGINLOOP
Esse buffer é o primeiro buffer em um loop. Esse sinalizador é usado apenas com buffers de saída.
WHDR_DONE
Defina pelo driver do dispositivo para indicar que ele foi concluído com o buffer e está retornando-o ao aplicativo.
WHDR_ENDLOOP
Esse buffer é o último buffer em um loop. Esse sinalizador é usado apenas com buffers de saída.
WHDR_INQUEUE
Definido pelo Windows para indicar que o buffer está na fila para reprodução.
WHDR_PREPARED
Definido pelo Windows para indicar que o buffer foi preparado com a função waveInPrepareHeader ou waveOutPrepareHeader .

dwLoops

Número de vezes para reproduzir o loop. Esse membro é usado apenas com buffers de saída.

lpNext

Reservado.

reserved

Reservado.

Comentários

Use os sinalizadores WHDR_BEGINLOOP e WHDR_ENDLOOP no membro dwFlags para especificar os blocos de dados iniciais e finais para looping. Para fazer loop em um único bloco, especifique ambos os sinalizadores para o mesmo bloco. Use o membro dwLoops na estrutura WAVEHDR para o primeiro bloco no loop para especificar o número de vezes para reproduzir o loop.

Os membros lpData, dwBufferLength e dwFlags devem ser definidos antes de chamar a função waveInPrepareHeader ou waveOutPrepareHeader . (Para qualquer função, o membro dwFlags deve ser definido como zero.)

Requisitos

Requisito Valor
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]
Cabeçalho mmeapi.h (inclua Windows.h)

Confira também

Áudio de forma de onda

Estruturas de forma de onda

Waveinprepareheader

Waveoutprepareheader