midiStreamPosition-Funktion (mmeapi.h)

  • Artikel

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