Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
Das angegebene Handle ist kein Streamhandle. |
|
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 |