Closes a sound previously opened with _SoundOpen.
#include <Sound.au3>
_SoundClose($aSnd_id)
| $aSnd_id | Sound ID array as returned by _SoundOpen() |
| Success: | 1 |
| Failure: | 0 and set @error |
| @error: | 1 = Failure |
| 3 = Invalid Sound ID. Use return array from _SoundOpen(). |
#include <Sound.au3>
Local $aSound = _SoundOpen(@WindowsDir & "\media\tada.wav")
If @error = 2 Then
MsgBox(0, "Error", "The file does not exist")
Exit
ElseIf @extended <> 0 Then
Local $iExtended = @extended ; Assign because @extended will be set after DllCall.
Local $tText = DllStructCreate("char[128]")
DllCall("winmm.dll", "short", "mciGetErrorStringA", "str", $iExtended, "ptr", DllStructGetPtr($tText), "int", 128)
MsgBox(0, "Error", "The open failed." & @CRLF & "Error Number: " & $iExtended & @CRLF & "Error Description: " & DllStructGetData($tText, 1) & @CRLF & "Please Note: The sound may still play correctly.")
Else
MsgBox(0, "Success", "The file opened successfully")
EndIf
If _SoundClose($aSound) Then
MsgBox(0, "Success", "The sound was closed successfully")
Else
MsgBox(0, "Error", "The file was not closed successfully")
EndIf