midiStreamOpen-Funktion (mmeapi.h)

  • Artikel

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