Share via

Função midiOutShortMsg (mmeapi.h)

  • Artigo

A função midiOutShortMsg envia uma mensagem MIDI curta para o dispositivo de saída MIDI especificado.

Sintaxe

MMRESULT midiOutShortMsg(
  HMIDIOUT hmo,
  DWORD    dwMsg
);

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.

dwMsg

Mensagem MIDI. A mensagem é empacotada em um valor DWORD com o primeiro byte da mensagem no byte de baixa ordem. A mensagem é empacotada nesse parâmetro da seguinte maneira.

Word Byte Uso
Alto Alta ordem Não usado.
Baixa ordem O segundo byte de dados MIDI (quando necessário).
Baixo Alta ordem O primeiro byte de dados MIDI (quando necessário).
Baixa ordem O status MIDI.
 

Os dois bytes de dados MIDI são opcionais, dependendo do byte midi status. Quando uma série de mensagens tem a mesma status byte, o byte status pode ser omitido das mensagens após a primeira da série, criando um status em execução. Empacote uma mensagem para executar status da seguinte maneira:

Word Byte Uso
Alto Alta ordem Não usado.
Baixa ordem Não usado.
Baixo Alta ordem O segundo byte de dados MIDI (quando necessário).
Baixa ordem O primeiro byte de dados MIDI.

Retornar valor

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_BADOPENMODE
 O aplicativo enviou uma mensagem sem um byte de status para um identificador de fluxo.
MIDIERR_NOTREADY
 O hardware está ocupado com outros dados.
MMSYSERR_INVALHANDLE
 O identificador de dispositivo especificado é inválido.

Comentários

Essa função é usada para enviar qualquer mensagem MIDI, exceto mensagens exclusivas do sistema ou de fluxo.

Essa função pode não retornar até que a mensagem tenha sido enviada para o dispositivo de saída. Você pode enviar mensagens curtas enquanto os fluxos estão sendo reproduzidos no mesmo dispositivo (embora não seja possível usar um status em execução nesse caso).

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]
Plataforma de Destino Windows
Cabeçalho mmeapi.h (inclua Windows.h)
Biblioteca Winmm.lib
DLL Winmm.dll

Confira também

Funções MIDI