Função midiOutUnprepareHeader (mmeapi.h)

A função midiOutUnprepareHeader limpa a preparação executada pela função midiOutPrepareHeader .

Sintaxe

MMRESULT midiOutUnprepareHeader(
  HMIDIOUT  hmo,
  LPMIDIHDR pmh,
  UINT      cbmh
);

Parâmetros

hmo

Manipule para o dispositivo de saída MIDI. Esse parâmetro também pode ser o identificador de uma conversão de fluxo MIDI para HMIDIOUT.

pmh

Ponteiro para uma estrutura MIDIHDR que identifica o buffer a ser limpo.

cbmh

Tamanho, em bytes, da estrutura MIDIHDR .

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
MIDIERR_STILLPLAYING	O buffer apontado por lpMidiOutHdr ainda está na fila.
MMSYSERR_INVALHANDLE	O identificador de dispositivo especificado é inválido.
MMSYSERR_INVALPARAM	O ponteiro ou estrutura especificado é inválido.

Comentários

Essa função é complementar à função midiOutPrepareHeader . Você deve chamar midiOutUnprepareHeader antes de liberar o buffer. Depois de passar um buffer para o driver de dispositivo com a função midiOutLongMsg , você deve aguardar até que o driver do dispositivo seja concluído com o buffer antes de chamar midiOutUnprepareHeader.

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

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

Alocando e preparando blocos de dados MIDI

Funções MIDI