Função midiStreamOpen (mmeapi.h)

Artigo
03/15/2023

A função midiStreamOpen abre um fluxo MIDI para saída. Por padrão, o dispositivo é aberto no modo pausado. O identificador de fluxo recuperado por essa função deve ser usado em todas as referências subsequentes ao fluxo.

Sintaxe

MMRESULT midiStreamOpen(
  LPHMIDISTRM phms,
  LPUINT      puDeviceID,
  DWORD       cMidi,
  DWORD_PTR   dwCallback,
  DWORD_PTR   dwInstance,
  DWORD       fdwOpen
);

Parâmetros

phms

Ponteiro para uma variável para conter o identificador de fluxo quando a função retornar.

puDeviceID

Ponteiro para um identificador de dispositivo. O dispositivo é aberto em nome do fluxo e fechado novamente quando o fluxo é fechado.

cMidi

Reservados; deve ser 1.

dwCallback

Ponteiro para uma função de retorno de chamada, um identificador de evento, um identificador de thread ou um identificador de uma janela ou thread chamado durante a reprodução MIDI para processar mensagens relacionadas ao progresso da reprodução. Se nenhum mecanismo de retorno de chamada for desejado, especifique NULL para esse parâmetro.

dwInstance

Dados de instância específicos do aplicativo que são retornados ao aplicativo com cada função de retorno de chamada.

fdwOpen

Sinalizador de retorno de chamada para abrir o dispositivo. Um dos sinalizadores de retorno de chamada a seguir deve ser especificado.

Valor	Significado
CALLBACK_EVENT	O parâmetro dwCallback é um identificador de evento. Esse mecanismo de retorno de chamada destina-se apenas à saída.
CALLBACK_FUNCTION	O parâmetro dwCallback é um endereço de procedimento de retorno de chamada. Para obter a assinatura de retorno de chamada, consulte MidiOutProc.
CALLBACK_NULL	Não há mecanismo de retorno de chamada. Essa é a configuração padrão.
CALLBACK_THREAD	O parâmetro dwCallback é um identificador de thread.
CALLBACK_WINDOW	O parâmetro dwCallback é um identificador de janela.

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_BADDEVICEID	O identificador de dispositivo especificado está fora do intervalo.
MMSYSERR_INVALPARAM	O parâmetro identificador ou sinalizador especificado é inválido.
MMSYSERR_NOMEM	O sistema não pode alocar ou bloquear memória.

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

Compartilhar via