MIDIOUTCAPSA-Struktur (mmeapi.h)

  • Artikel

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

Syntax

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;

Members

wMid

Hersteller-ID des Gerätetreibers für das MIDI-Ausgabegerät. Hersteller-IDs werden unter Hersteller- und Produkt-IDs definiert.

wPid

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

vDriverVersion

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

szPname[MAXPNAMELEN]

Produktname in einer Zeichenfolge mit NULL-Beendigung.

wTechnology

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

Name BESCHREIBUNG
MOD_MIDIPORT
 MIDI-Hardwareport.
MOD_SYNTH
 Synthesizer.
MOD_SQSYNTH
 Quadratwellen-Synthesizer.
MOD_FMSYNTH
 FM-Synthesizer.
MOD_MAPPER
 Microsoft MIDI-Mapper.
MOD_WAVETABLE
 Hardware-Wavetable-Synthesizer.
MOD_SWSYNTH
 Softwaresynthesizer.

wVoices

Anzahl der Stimmen, die von einem internen Synthesizergerät unterstützt werden. Wenn das Gerät ein Port ist, ist dieser Member nicht sinnvoll und auf 0 festgelegt.

wNotes

Maximale Anzahl gleichzeitiger Noten, die von einem internen Synthesizergerät wiedergegeben werden können. Wenn das Gerät ein Port ist, ist dieser Member nicht sinnvoll und auf 0 festgelegt.

wChannelMask

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

dwSupport

Optionale Funktionen, die vom Gerät unterstützt werden. Dies kann eine oder mehrere der folgenden Optionen sein:

Name BESCHREIBUNG
MIDICAPS_CACHE
 Unterstützt die Patchzwischenspeicherung.
MIDICAPS_LRVOLUME
 Unterstützt eine separate Lautstärkeregelung für links und rechts.
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.

Hinweise

Hinweis

Der mmeapi.h-Header definiert MIDIOUTCAPS als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile mmeapi.h (Einschließen von Windows.h)

Weitere Informationen

MIDI-Strukturen

Musical Instrument Digital Interface (MIDI)

midiStreamOut