waveOutClose-Funktion (mmeapi.h)

Die waveOutClose-Funktion schließt das angegebene Waveform-Audioausgabegerät.

Syntax

MMRESULT waveOutClose(
  HWAVEOUT hwo
);

Parameter

hwo

Handle mit dem Waveform-Audioausgabegerät. Wenn die Funktion erfolgreich ist, ist das Handle nach diesem Aufruf nicht mehr gültig.

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.
WAVERR_STILLPLAYING	Es gibt noch Puffer in der Warteschlange.

Hinweise

Der Schließenvorgang schlägt fehl, wenn das Gerät weiterhin einen Waveform-Audiopuffer wiedergibt, der zuvor durch aufrufen von waveOutWrite gesendet wurde. Vor dem Aufrufen von waveOutClose muss die Anwendung warten, bis alle Puffer die Wiedergabe beenden oder die waveOutReset-Funktion aufrufen, um die Wiedergabe zu beenden.

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

Waveform Audio

Wellenformfunktionen