Share via

Função midiStreamOut (mmeapi.h)

  • Artigo

A função midiStreamOut reproduz ou enfileira um fluxo (buffer) de dados MIDI em um dispositivo de saída MIDI.

Sintaxe

MMRESULT midiStreamOut(
  HMIDISTRM hms,
  LPMIDIHDR pmh,
  UINT      cbmh
);

Parâmetros

hms

Manipule para um fluxo MIDI. Esse identificador deve ter sido retornado por uma chamada para a função midiStreamOpen . Esse identificador identifica o dispositivo de saída.

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
MMSYSERR_NOMEM
 O sistema não pode alocar ou bloquear memória.
MIDIERR_STILLPLAYING
 O buffer de saída apontado por lpMidiHdr ainda está em execução ou está na fila de uma chamada anterior para midiStreamOut.
MIDIERR_UNPREPARED
 O cabeçalho apontado por lpMidiHdr não foi preparado.
MMSYSERR_INVALHANDLE
 O identificador de dispositivo especificado é inválido.
MMSYSERR_INVALPARAM
 O ponteiro especificado por lpMidiHdr é inválido.

Comentários

Antes que o buffer seja passado para midiStreamOpen, ele deve ser preparado usando a função midiOutPrepareHeader .

Como a função midiStreamOpen abre o dispositivo de saída no modo pausado, você deve chamar a função midiStreamRestart antes de usar midiStreamOut para iniciar a reprodução.

Para a implementação atual dessa função, o buffer deve ser menor que 64K.

O buffer apontado pela estrutura MIDIHDR contém um ou mais eventos MIDI, cada um dos quais é definido por uma estrutura MIDIEVENT .

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