waveOutGetPosition-Funktion (mmeapi.h)

  • Artikel

Die waveOutGetPosition-Funktion ruft die aktuelle Wiedergabeposition des angegebenen Waveform-Audioausgabegeräts ab.

Syntax

MMRESULT waveOutGetPosition(
  HWAVEOUT hwo,
  LPMMTIME pmmt,
  UINT     cbmmt
);

Parameter

hwo

Handle mit dem Waveform-Audioausgabegerät.

pmmt

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_NODRIVER
 Es ist kein Gerätetreiber vorhanden.
MMSYSERR_NOMEM
 Speicher kann nicht zugeordnet oder gesperrt werden.

Hinweise

Legen Sie vor dem Aufrufen dieser Funktion das wType-Element der MMTIME-Struktur so fest, dass das gewünschte Zeitformat angegeben wird. Überprüfen Sie nach dem Aufrufen dieser Funktion wType , um zu ermitteln, ob das Zeitformat unterstützt wird. Wenn das 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

   
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

Waveform Audio

Wellenformfunktionen