Compartilhar via


Função midiOutLongMsg (mmeapi.h)

A função midiOutLongMsg envia uma mensagem MIDI exclusiva do sistema para o dispositivo de saída MIDI especificado.

Sintaxe

MMRESULT midiOutLongMsg(
  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 MIDI.

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_NOTREADY
O hardware está ocupado com outros dados.
MIDIERR_UNPREPARED
O buffer apontado por lpMidiOutHdr não foi preparado.
MMSYSERR_INVALHANDLE
O identificador de dispositivo especificado é inválido.
MMSYSERR_INVALPARAM
O ponteiro ou estrutura especificado é inválido.

Comentários

Antes que o buffer seja passado para midiOutLongMsg, ele deve ser preparado usando a função midiOutPrepareHeader . O driver de dispositivo de saída MIDI determina se os dados são enviados de forma síncrona ou assíncrona.

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

Funções MIDI