waveOutReset-Funktion (mmeapi.h)

Die waveOutReset-Funktion beendet die Wiedergabe auf dem angegebenen Waveform-Audioausgabegerät und setzt die aktuelle Position auf 0 zurück. Alle ausstehenden Wiedergabepuffer werden als erledigt (WHDR_DONE) markiert und an die Anwendung zurückgegeben.

Syntax

MMRESULT waveOutReset(
  HWAVEOUT hwo
);

Parameter

hwo

Handle für das Waveform-Audio-Ausgabegerät.

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.
MMSYSERR_NOTSUPPORTED
Das angegebene Gerät ist synchron und unterstützt das Anhalten nicht.

Hinweise

Nachdem diese Funktion zurückgegeben wurde, kann die Anwendung neue Wiedergabepuffer an das Gerät senden, indem sie waveOutWrite aufruft, oder das Gerät durch Aufrufen von waveOutClose schließen.

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

Weitere Informationen

Waveform-Audio

Wellenformfunktionen