Função midiOutShortMsg (mmeapi.h)

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