midiStreamOpen-Funktion (mmeapi.h)

Artikel
08/24/2023

Die midiStreamOpen-Funktion öffnet einen MIDI-Stream für die Ausgabe. Standardmäßig wird das Gerät im angehaltenen Modus geöffnet. Das von dieser Funktion abgerufene Streamhandle muss in allen nachfolgenden Verweisen auf den Stream verwendet werden.

Syntax

MMRESULT midiStreamOpen(
  LPHMIDISTRM phms,
  LPUINT      puDeviceID,
  DWORD       cMidi,
  DWORD_PTR   dwCallback,
  DWORD_PTR   dwInstance,
  DWORD       fdwOpen
);

Parameter

phms

Zeiger auf eine Variable, die das Streamhandle enthält, wenn die Funktion zurückgibt.

puDeviceID

Zeiger auf einen Gerätebezeichner. Das Gerät wird im Auftrag des Datenstroms geöffnet und beim Schließen des Datenstroms erneut geschlossen.

cMidi

Reserviert; muss 1 sein.

dwCallback

Zeiger auf eine Rückruffunktion, ein Ereignishandle, einen Threadbezeichner oder ein Handle eines Fensters oder Threads, das während der MIDI-Wiedergabe aufgerufen wird, um Nachrichten im Zusammenhang mit dem Fortschritt der Wiedergabe zu verarbeiten. Wenn kein Rückrufmechanismus gewünscht ist, geben Sie NULL für diesen Parameter an.

dwInstance

Anwendungsspezifische instance Daten, die mit jeder Rückruffunktion an die Anwendung zurückgegeben werden.

fdwOpen

Rückrufflag zum Öffnen des Geräts. Eines der folgenden Rückrufflags muss angegeben werden.

Wert	Bedeutung
CALLBACK_EVENT	Der dwCallback-Parameter ist ein Ereignishandle. Dieser Rückrufmechanismus ist nur für die Ausgabe vorgesehen.
CALLBACK_FUNCTION	Der dwCallback-Parameter ist eine Rückrufprozeduradresse. Die Rückrufsignatur finden Sie unter MidiOutProc.
CALLBACK_NULL	Es gibt keinen Rückrufmechanismus. Dies ist die Standardeinstellung.
CALLBACK_THREAD	Der dwCallback-Parameter ist ein Threadbezeichner.
CALLBACK_WINDOW	Der dwCallback-Parameter ist ein Fensterhandle.

Rückgabewert

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

Rückgabecode	Beschreibung
MMSYSERR_BADDEVICEID	Der angegebene Gerätebezeichner liegt außerhalb des Bereichs.
MMSYSERR_INVALPARAM	Der angegebene Handle- oder Flags-Parameter ist ungültig.
MMSYSERR_NOMEM	Das System kann arbeitsspeicher nicht zuordnen oder sperren.

Anforderungen


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ßlich Windows.h)
Bibliothek	Winmm.lib
DLL	Winmm.dll

Weitere Informationen

MIDI-Funktionen

Freigeben über