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 |
---|---|
|
Das angegebene Gerätehandle ist ungültig. |
|
Es ist kein Gerätetreiber vorhanden. |
|
Speicher kann nicht zugeordnet oder gesperrt werden. |
|
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 |