MIDIOUTCAPSW-Struktur (mmeapi.h)

  • Artikel

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

Syntax

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;

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.

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 nicht codierungsneutralem Code 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
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