Share via

Função midiStreamProperty (mmeapi.h)

  • Artigo

A função midiStreamProperty define ou recupera propriedades de um fluxo de dados MIDI associado a um dispositivo de saída MIDI.

Sintaxe

MMRESULT midiStreamProperty(
  HMIDISTRM hms,
  LPBYTE    lppropdata,
  DWORD     dwProperty
);

Parâmetros

hms

Manipule para o dispositivo MIDI ao qual a propriedade está associada.

lppropdata

Ponteiro para os dados da propriedade.

dwProperty

Sinalizadores que especificam a ação a ser executada e identificam a propriedade apropriada do fluxo de dados MIDI. A função midiStreamProperty requer a configuração de dois sinalizadores em cada uso. Um sinalizador (MIDIPROP_GET ou MIDIPROP_SET) especifica uma ação e o outro identifica uma propriedade específica para examinar ou editar.

Valor Significado
MIDIPROP_GET Recupera a configuração atual da propriedade fornecida.
MIDIPROP_SET Define a propriedade fornecida.
MIDIPROP_TEMPO Recupera a propriedade tempo. O parâmetro lppropdata aponta para uma estrutura MIDIPROPTEMPO . O valor de tempo atual pode ser recuperado a qualquer momento. Os dispositivos de saída definem o ritmo inserindo eventos MEVT_TEMPO nos dados MIDI.
MIDIPROP_TIMEDIV Especifica a propriedade de divisão de tempo. Você pode obter ou definir essa propriedade. O parâmetro lppropdata aponta para uma estrutura MIDIPROPTIMEDIV . Essa propriedade só pode ser definida quando o dispositivo é interrompido.

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
MMSYSERR_INVALHANDLE
 O identificador especificado não é um identificador de fluxo.
MMSYSERR_INVALPARAM
 O parâmetro identificador ou sinalizador especificado é inválido.

Comentários

Essas propriedades são as propriedades padrão definidas pelo sistema. Os gravadores de driver podem implementar e documentar suas próprias propriedades.

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