Struttura MIDIOUTCAPSW (mmeapi.h)

Articolo
03/15/2023

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

Sintassi

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;

Members

wMid

Identificatore produttore del driver di dispositivo per il dispositivo di output MIDI. Gli identificatori del produttore sono definiti in Identificatori produttore e prodotto.

wPid

Identificatore del prodotto del dispositivo di output MIDI. Gli identificatori del prodotto sono definiti in Identificatori di prodotto e produttore.

vDriverVersion

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

szPname[MAXPNAMELEN]

Nome del prodotto in una stringa con terminazione null.

wTechnology

Tipo del dispositivo di output MIDI. I valori validi sono i seguenti:

Nome	Descrizione
MOD_MIDIPORT	Porta hardware MIDI.
MOD_SYNTH	Sintetizzatore.
MOD_SQSYNTH	Sintetizzatore a onda quadrata.
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 ed è 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 ed è impostato su 0.

wChannelMask

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

dwSupport

Funzionalità facoltative supportate dal dispositivo. Può essere una o più delle seguenti:

Nome	Descrizione
MIDICAPS_CACHE	Supporta la memorizzazione nella cache delle patch.
MIDICAPS_LRVOLUME	Supporta un controllo del volume a sinistra e destro separato.
MIDICAPS_STREAM	Fornisce il supporto diretto per la funzione midiStreamOut .
MIDICAPS_VOLUME	Supporta il controllo 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 sui canali sinistro e destro, sia i MIDICAPS_VOLUME che i flag di MIDICAPS_LRVOLUME verranno impostati per questo membro.

Commenti

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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	mmeapi.h (includere Windows.h)

Vedi anche

Strutture MIDI

Interfaccia digitale dello strumento musicale (MIDI)

midiStreamOut

Condividi tramite