Share via

Estrutura MIDIOUTCAPSW (mmeapi.h)

  • Artigo

A estrutura MIDIOUTCAPS descreve os recursos de um dispositivo de saída MIDI.

Sintaxe

typedef struct tagMIDIOUTCAPSW {
  WORD      wMid;
  WORD      wPid;
  MMVERSION vDriverVersion;
  WCHAR     szPname[MAXPNAMELEN];
  WORD      wTechnology;
  WORD      wVoices;
  WORD      wNotes;
  WORD      wChannelMask;
  DWORD     dwSupport;
} MIDIOUTCAPSW, *PMIDIOUTCAPSW, *NPMIDIOUTCAPSW, *LPMIDIOUTCAPSW;

Membros

wMid

Identificador do fabricante do driver de dispositivo para o dispositivo de saída MIDI. Os identificadores do fabricante são definidos em Identificadores de Fabricante e Produto.

wPid

Identificador do produto do dispositivo de saída MIDI. Os identificadores de produto são definidos em Identificadores de Produto e Fabricante.

vDriverVersion

Número de versão do driver de dispositivo para o dispositivo de saída MIDI. O byte de alta ordem é o número de versão principal e o byte de baixa ordem é o número de versão secundária.

szPname[MAXPNAMELEN]

Nome do produto em uma cadeia de caracteres terminada em nulo.

wTechnology

Tipo do dispositivo de saída MIDI. Este valor pode ser um dos seguintes:

Nome Descrição
MOD_MIDIPORT
 Porta de hardware MIDI.
MOD_SYNTH
 Sintetizador.
MOD_SQSYNTH
 Sintetizador de ondas quadradas.
MOD_FMSYNTH
 Sintetizador FM.
MOD_MAPPER
 Mapeador do Microsoft MIDI.
MOD_WAVETABLE
 Sintetizador de tabela de ondas de hardware.
MOD_SWSYNTH
 Sintetizador de software.

wVoices

Número de vozes compatíveis com um dispositivo sintetizador interno. Se o dispositivo for uma porta, esse membro não será significativo e será definido como 0.

wNotes

Número máximo de anotações simultâneas que podem ser reproduzidas por um dispositivo sintetizador interno. Se o dispositivo for uma porta, esse membro não será significativo e será definido como 0.

wChannelMask

Canais aos quais um dispositivo sintetizador interno responde, em que o bit menos significativo se refere ao canal 0 e ao bit mais significativo para o canal 15. Dispositivos de porta que transmitem em todos os canais definem esse membro como 0xFFFF.

dwSupport

Funcionalidade opcional compatível com o dispositivo. Poderá ser um ou mais dos seguintes:

Nome Descrição
MIDICAPS_CACHE
 Dá suporte ao cache de patch.
MIDICAPS_LRVOLUME
 Dá suporte ao controle de volume separado à esquerda e à direita.
MIDICAPS_STREAM
 Fornece suporte direto para a função midiStreamOut .
MIDICAPS_VOLUME
 Dá suporte ao controle de volume.
 

Se um dispositivo der suporte a alterações de volume, o sinalizador MIDICAPS_VOLUME será definido para o membro dwSupport. Se um dispositivo der suporte a alterações de volume separadas nos canais esquerdo e direito, os sinalizadores MIDICAPS_VOLUME e MIDICAPS_LRVOLUME serão definidos para esse membro.

Comentários

Observação

O cabeçalho mmeapi.h define MIDIOUTCAPS como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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]
Cabeçalho mmeapi.h (inclua Windows.h)

Confira também

Estruturas MIDI

MIDI (Interface Digital do Instrumento Musical)

midiStreamOut