Struttura MIDIOUTCAPSA (mmeapi.h)

Articolo
11/20/2024

La struttura MIDIOUTCAPS descrive le funzionalità di un dispositivo di output MIDI.

Sintassi

typedef struct tagMIDIOUTCAPSA {
  WORD      wMid;
  WORD      wPid;
  MMVERSION vDriverVersion;
  CHAR      szPname[MAXPNAMELEN];
  WORD      wTechnology;
  WORD      wVoices;
  WORD      wNotes;
  WORD      wChannelMask;
  DWORD     dwSupport;
} MIDIOUTCAPSA, *PMIDIOUTCAPSA, *NPMIDIOUTCAPSA, *LPMIDIOUTCAPSA;

Membri

wMid

Identificatore del produttore del driver di dispositivo per il dispositivo di output MIDI. Gli identificatori del produttore sono definiti in Manufacturer e Product Identifiers.

wPid

Identificatore del prodotto del dispositivo di output MIDI. Gli identificatori di prodotto sono definiti in Manufacturer e Product Identifiers.

vDriverVersion

Numero di versione del driver di dispositivo per il dispositivo di output MIDI. Il byte di ordine elevato è il numero di versione principale e il byte di ordine basso è il numero di versione secondario.

szPname[MAXPNAMELEN]

Nome del prodotto in una stringa con terminazione Null.

wTechnology

Tipo del dispositivo di output MIDI. Questo valore può essere uno dei seguenti:

Nome	Descrizione
MOD_MIDIPORT	Porta hardware MIDI.
MOD_SYNTH	Sintetizzatore.
MOD_SQSYNTH	Sintetizzatore a onde quadrate.
MOD_FMSYNTH	Sintetizzatore FM.
MOD_MAPPER	Microsoft MIDI mapper.
MOD_WAVETABLE	Sintetizzatore wavetable hardware.
MOD_SWSYNTH	Sintetizzatore software.

wVoices

Numero di voci supportate da un dispositivo sintetizzatore interno. Se il dispositivo è una porta, questo membro non è significativo e viene impostato su 0.

wNotes

Numero massimo di note simultanee che possono essere riprodotte da un dispositivo sintetizzatore interno. Se il dispositivo è una porta, questo membro non è significativo e viene impostato su 0.

wChannelMask

Canali a cui risponde un dispositivo sintetizzatore interno, in cui il bit meno significativo fa riferimento al canale 0 e al bit più significativo al canale 15. I dispositivi porta che trasmettono su tutti i canali impostano questo membro su 0xFFFF.

dwSupport

Funzionalità facoltative supportate dal dispositivo. Può trattarsi di uno o più dei seguenti elementi:

Nome	Descrizione
MIDICAPS_CACHE	Supporta la memorizzazione nella cache delle patch.
MIDICAPS_LRVOLUME	Supporta controlli del volume separati da sinistra e destra.
MIDICAPS_STREAM	Fornisce supporto diretto per la funzione midiStreamOut.
MIDICAPS_VOLUME	Supporta il controllo del volume.

Se un dispositivo supporta le modifiche al volume, il flag di MIDICAPS_VOLUME verrà impostato per il membro dwSupport. Se un dispositivo supporta modifiche di volume separate nei canali sinistro e destro, verranno impostati sia il MIDICAPS_VOLUME che i flag MIDICAPS_LRVOLUME per questo membro.

Osservazioni

Nota

L'intestazione mmeapi.h definisce MIDIOUTCAPS come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
intestazione	mmeapi.h (include Windows.h)

Vedere anche

strutture MIDI

Musical Instrument Digital Interface (MIDI)

midiStreamOut

Condividi tramite