midiStreamProperty-Funktion (mmeapi.h)

  • Artikel

Die funktion midiStreamProperty legt Eigenschaften eines MIDI-Datenstroms fest, der einem MIDI-Ausgabegerät zugeordnet ist, oder ruft diese ab.

Syntax

MMRESULT midiStreamProperty(
  HMIDISTRM hms,
  LPBYTE    lppropdata,
  DWORD     dwProperty
);

Parameter

hms

Handle für das MIDI-Gerät, dem die Eigenschaft zugeordnet ist.

lppropdata

Zeiger auf die Eigenschaftendaten.

dwProperty

Flags, die die auszuführende Aktion angeben und die entsprechende Eigenschaft des MIDI-Datenstroms identifizieren. Für die midiStreamProperty-Funktion müssen bei jeder Verwendung zwei Flags festgelegt werden. Ein Flag (entweder MIDIPROP_GET oder MIDIPROP_SET) gibt eine Aktion an, und das andere gibt eine bestimmte Eigenschaft an, die untersucht oder bearbeitet werden soll.

Wert Bedeutung
MIDIPROP_GET Ruft die aktuelle Einstellung der angegebenen Eigenschaft ab.
MIDIPROP_SET Legt die angegebene Eigenschaft fest.
MIDIPROP_TEMPO Ruft die tempo-Eigenschaft ab. Der parameter lppropdata verweist auf eine MIDIPROPTEMPO-Struktur . Der aktuelle Tempowert kann jederzeit abgerufen werden. Ausgabegeräte legen das Tempo fest, indem MEVT_TEMPO Ereignisse in die MIDI-Daten eingefügt werden.
MIDIPROP_TIMEDIV Gibt die Zeitteilungseigenschaft an. Sie können diese Eigenschaft abrufen oder festlegen. Der parameter lppropdata verweist auf eine MIDIPROPTIMEDIV-Struktur . Diese Eigenschaft kann nur festgelegt werden, wenn das Gerät beendet wird.

Rückgabewert

Gibt MMSYSERR_NOERROR zurück, wenn erfolgreich oder andernfalls ein Fehler aufgetreten ist. Mögliche Fehlerwerte sind:

Rückgabecode Beschreibung
MMSYSERR_INVALHANDLE
 Das angegebene Handle ist kein Streamhandle.
MMSYSERR_INVALPARAM
 Der angegebene Handle- oder Flags-Parameter ist ungültig.

Hinweise

Diese Eigenschaften sind die vom System definierten Standardeigenschaften. Treiberautoren können eigene Eigenschaften implementieren und dokumentieren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mmeapi.h (Einschließen von Windows.h)
Bibliothek Winmm.lib
DLL Winmm.dll

Weitere Informationen

MIDI-Funktionen