MIDIOUTCAPS-Struktur (mmeapi.h)

  • Artikel

Die MIDIOUTCAPS-Struktur beschreibt die Funktionen eines MIDI-Ausgabegeräts.

Syntax

typedef struct midioutcaps_tag {
  WORD    wMid;
  WORD    wPid;
  VERSION vDriverVersion;
  char    szPname[MAXPNAMELEN];
  WORD    wTechnology;
  WORD    wVoices;
  WORD    wNotes;
  WORD    wChannelMask;
  DWORD   dwSupport;
} MIDIOUTCAPS, *PMIDIOUTCAPS, *NPMIDIOUTCAPS, *LPMIDIOUTCAPS;

Member

wMid

Hersteller-ID des Gerätetreibers für das MIDI-Ausgabegerät. Herstellerbezeichner sind in Hersteller- und Produktbezeichnern definiert.

wPid

Produkt-ID des MIDI-Ausgabegeräts. Produktbezeichner werden unter Hersteller- und Produktbezeichner definiert.

vDriverVersion

Versionsnummer des Gerätetreibers für das MIDI-Ausgabegerät. Das hochgeordnete Byte ist die Hauptversionsnummer, und das Byte mit niedriger Reihenfolge ist die Nebenversionsnummer.

szPname[MAXPNAMELEN]

Produktname in einer NULL-beendeten Zeichenfolge.

wTechnology

Typ des MIDI-Ausgabegeräts. Die folgenden Werte sind möglich:

Name BESCHREIBUNG
MOD_MIDIPORT
 MIDI-Hardwareport.
MOD_SYNTH
 Synthesizer.
MOD_SQSYNTH
 Quadratwellensynthesizer.
MOD_FMSYNTH
 FM-Synthesizer.
MOD_MAPPER
 Microsoft MIDI-Mapper.
MOD_WAVETABLE
 Hardware wavetable Synthesizer.
MOD_SWSYNTH
 Softwaresyntheizer.

wVoices

Anzahl der Stimmen, die von einem internen Synthesizergerät unterstützt werden. Wenn es sich bei dem Gerät um einen Port handelt, ist dieser Member nicht aussagekräftig und auf 0 festgelegt.

wNotes

Maximale Anzahl gleichzeitiger Noten, die von einem internen Synthesizergerät wiedergegeben werden können. Wenn es sich bei dem Gerät um einen Port handelt, ist dieser Member nicht aussagekräftig und auf 0 festgelegt.

wChannelMask

Kanäle, auf die ein internes Synthesizergerät reagiert, wobei sich das geringste signifikante Bit auf Kanal 0 und das wichtigste Bit auf Kanal 15 bezieht. Portieren von Geräten, die auf allen Kanälen übertragen, legen Sie dieses Element auf 0xFFFF fest.

dwSupport

Optionale Funktionen, die vom Gerät unterstützt werden. Es kann mindestens eine der folgenden Elemente sein:

Name BESCHREIBUNG
MIDICAPS_CACHE
 Unterstützt Patchzwischenspeicherung.
MIDICAPS_LRVOLUME
 Unterstützt eine separate Linke und rechte Lautstärkeregelung.
MIDICAPS_STREAM
 Bietet direkte Unterstützung für die midiStreamOut-Funktion .
MIDICAPS_VOLUME
 Unterstützt die Lautstärkeregelung.
 

Wenn ein Gerät Volumeänderungen unterstützt, wird das MIDICAPS_VOLUME-Flag für das dwSupport-Element festgelegt. Wenn ein Gerät separate Volumeänderungen auf dem linken und rechten Kanal unterstützt, werden sowohl die MIDICAPS_VOLUME- als auch die MIDICAPS_LRVOLUME-Flags für dieses Element festgelegt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile mmeapi.h (einschließlich Windows.h)

Weitere Informationen

MIDI-Strukturen

Musical Instrument Digital Interface (MIDI)

midiStreamOut