MIDIOUTCAPSA-Struktur (mmeapi.h)

Artikel
11/20/2024

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;

Angehörige

wMid

Herstellerbezeichner des Gerätetreibers für das MIDI-Ausgabegerät. Hersteller-IDs werden in Hersteller- und Produkt-IDsdefiniert.

wPid

Produkt-ID des MIDI-Ausgabegeräts. Produkt-IDs werden in Hersteller- und Produkt-IDsdefiniert.

vDriverVersion

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

szPname[MAXPNAMELEN]

Produktname in einer mit Null beendeten Zeichenfolge.

wTechnology

Typ des MIDI-Ausgabegeräts. Dieser Wert kann eine der folgenden Sein:

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	Softwaresynthesizer.

wVoices

Die Anzahl der von einem internen Synthesizergerät unterstützten Stimmen. Wenn es sich bei dem Gerät um einen Port handelt, ist dieses Element nicht aussagekräftig und auf 0 festgelegt.

wNotes

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

wChannelMask

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

dwSupport

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

Name	Beschreibung
MIDICAPS_CACHE	Unterstützt das Zwischenspeichern von Patches.
MIDICAPS_LRVOLUME	Unterstützt 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 den linken und rechten Kanälen unterstützt, werden sowohl die MIDICAPS_VOLUME als auch die MIDICAPS_LRVOLUME Flags für dieses Element festgelegt.

Bemerkungen

Anmerkung

Der mmeapi.h-Header definiert MIDIOUTCAPS als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Header-	mmeapi.h (enthalten Windows.h)

Siehe auch

MIDI-Strukturen

Musical Instrument Digital Interface (MIDI)

midiStreamOut-

Freigeben über