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