UDF > Sound >

_SoundOpen

Ouvre un fichier audio pour une utilisation avec d'autres fonctions _Sound

#include <Sound.au3>
_SoundOpen ( $sFilePath )

Param�tre

$sFilePath Nom complet du fichier son

Valeur de retour

Succ�s: Retourne un tableau de 4 �l�ments contenant les informations suivantes:
    $aArray[0] = Cha�ne d'identification du fichier son
    $aArray[1] = Facteur de correction de la longueur VBR
    $aArray[2] = Facteur de correction de la synchronisation VBR
    $aArray[3] = Marqueur Sound ID
�chec: Retourne 0 et d�finit @error <> 0.
@error: 1 - Erreur d'ouverture MCI
2 - Le fichier n'existe pas
@extended: Entier autre que 0 = Erreur MCI

Remarque

Bien que beaucoup de fonctions _Sound...() accepteront le nom de fichier comme param�tre, s'il est possible que le fichier soit encod� VBR (d�bit binaire variable), il est fortement recommand� d'utiliser _SoundOpen() pr�alablement et d'utiliser ensuite le tableau retourn� comme param�tre d'identit� dans les autres fonctions _Sound...(). En effet, la DLL MCI suppose que tous les fichiers sont encod�s CBR (d�bit constant de bit) et produit des r�sultats incorrects pour ces fonctions _Sound...() avec la longueur et la position quand le fichier son a �t� encod� VBR (d�bit binaire variable). Si vous utilisez le tableau en tant que param�tre ID avec les fonctions _Sound...() qui modifient les facteurs de correction VBR (_SOUNDSTOP()) le tableau ID sera mise � jour en cas de besoin.
Les �l�ments individuels du tableau retourn� n'ont aucune utilit� en dehors des fonctions _Sound et leur usage interne est transparent pour l'utilisateur.

En relation

_SoundClose, _SoundLength, _SoundPause, _SoundPlay, _SoundPos, _SoundResume, _SoundStatus, _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, "Error", "L'ouverture a �chou�e." & @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", "Le fichier a �t� ouvert avec succ�s")
EndIf

_SoundClose($aSound)