midiStreamPosition-Funktion (mmeapi.h)

Artikel
08/24/2023

Die midiStreamPosition-Funktion ruft die aktuelle Position in einem MIDI-Stream ab.

Syntax

MMRESULT midiStreamPosition(
  HMIDISTRM hms,
  LPMMTIME  lpmmt,
  UINT      cbmmt
);

Parameter

hms

Handle zu einem MIDI-Stream. Dieses Handle muss durch einen Aufruf der midiStreamOpen-Funktion zurückgegeben worden sein. Dieses Handle identifiziert das Ausgabegerät.

lpmmt

Zeiger auf eine MMTIME-Struktur .

cbmmt

Größe der MMTIME-Struktur in Bytes.

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 Gerätehandle ist ungültig.
MMSYSERR_INVALPARAM	Der angegebene Zeiger oder die angegebene Struktur ist ungültig.

Hinweise

Legen Sie vor dem Aufrufen von midiStreamPosition das wType-Element der MMTIME-Struktur fest, um das gewünschte Zeitformat anzugeben. Überprüfen Sie nach dem Aufrufen von midiStreamPosition das wType-Element , um zu ermitteln, ob das gewünschte Zeitformat unterstützt wird. Wenn das gewünschte Format nicht unterstützt wird, gibt wType ein alternatives Format an.

Die Position wird auf null festgelegt, wenn das Gerät geöffnet oder zurückgesetzt wird.

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

Weitere Informationen

MIDI-Funktionen

Freigeben über