Compartilhar via


Função midiOutReset (mmeapi.h)

A função midiOutReset desativa todas as anotações em todos os canais MIDI para o dispositivo de saída MIDI especificado.

Sintaxe

MMRESULT midiOutReset(
  HMIDIOUT hmo
);

Parâmetros

hmo

Identificador 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.

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
MMSYSERR_INVALHANDLE
O identificador de dispositivo especificado é inválido.

Comentários

Todos os buffers de saída de fluxo ou exclusivos do sistema pendentes são retornados para a função de retorno de chamada e o sinalizador MHDR_DONE é definido no membro dwFlags da estrutura MIDIHDR .

Encerrar uma mensagem exclusiva do sistema sem enviar um byte EOX (fim exclusivo) pode causar problemas para o dispositivo receptor. A função midiOutReset não envia um byte EOX quando encerra uma mensagem exclusiva do sistema – os aplicativos são responsáveis por fazer isso.

Para desativar todas as anotações, uma mensagem de anotação para cada anotação em cada canal é enviada. Além disso, o controlador de sustentação é desativado para cada canal.

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