UDF > Sound >

_SoundPlay

Joue un fichier son

#include <Sound.au3>
_SoundPlay ( $aSndID [, $iWait = 0] )

Param�tres

$aSndID Tableau d'identification du son retourn� par _SoundOpen() ou le nom du fichier
$iWait [optionnel] Cet indicateur d�termine si le script doit attendre que le son soit termin� avant de poursuivre :
    0 = le script continue pendant que le son joue (par d�faut)
    1 = attend que le son soit termin� pour continuer

Valeur de retour

Succ�s: Retourne 1.
�chec: Retourne 0 et d�finit @error <> 0.
@error: 1 = La lecture du son a �chou�e
2 = le param�tre $iWait est invalide
3 = ID du son invalide. Utiliser le tableau retourn� par _SoundOpen() ou un nom de fichier valide.

Remarque

Sous Windows Vista ou une version ult�rieure, les fichiers "\Windows\Media\..." contenant des espaces doivent �tre ouverts avec _SoundOpen() avant d'utiliser cette fonction avec le tableau d'ID du son retourn�.

En relation

_SoundOpen, _SoundPause, _SoundResume, _SoundSeek, _SoundStop

Exemple

#include <MsgBoxConstants.au3>
#include <Sound.au3>

Local $aSound = _SoundOpen(@WindowsDir & "\media\tada.wav")
If @error = 2 Then
    MsgBox($MB_SYSTEMMODAL, "Error", "Le fichier n'existe pas.")
    Exit
ElseIf @extended <> 0 Then
    Local $iExtended = @extended ; Parce que @extended sera d�fini apr�s DllCall.
    Local $tText = DllStructCreate("char[128]")
    DllCall("winmm.dll", "short", "mciGetErrorStringA", "str", $iExtended, "ptr", DllStructGetPtr($tText), "int", 128)
    MsgBox($MB_SYSTEMMODAL, "Erreur", "L'ouverture a �chou�." & @CRLF & "Num�ro de l'erreur: " & $iExtended & @CRLF & "Description de l'erreur: " & DllStructGetData($tText, 1) & @CRLF & "Notez SVP: Le son peut toujours jouer correctement.")
Else
    MsgBox($MB_SYSTEMMODAL, "Succ�s", "L'ouverture du fichier a r�ussi.")
EndIf

_SoundPlay($aSound, 1)

_SoundClose($aSound)