|
|
|
|
- Procédure permettant de gérer les différents événements rencontrés
- Sessions et pistes
- Compilation
- CD/DVD gravé de type audio
- Configuration nécessaire
GraveurEnregistre (Fonction) En anglais : BurnerSave Grave les fichiers présents dans la compilation sur le CD ou le DVD. Lors de la gravure, la fonction GraveurEnregistre appelle régulièrement une procédure spécifique écrite en WLangage. Cette procédure permet de gérer les différents événements rencontrés lors de la gravure. Remarques : - Après l'appel de la fonction GraveurEnregistre, la compilation en cours est automatiquement supprimée.
- L'utilisation de cette fonction n'est pas bloquante. Pour savoir si la gravure est terminée, utilisez la procédure WLangage appelée régulièrement par la fonction GraveurEnregistre.
// Gravure réelle du CD // Le tiroir du graveur s'ouvrira automatiquement à la fin de la gravure ResGravure est un booléen ResGravure = GraveurEnregistre(graveurEjecteAuto, ProcGravureCD) // Pour visualiser cet exemple en totalité, cliquez sur le lien "Exemple"
Syntaxe
<Résultat> = GraveurEnregistre(<Options de gravure> [, <Procédure WLangage> [, <Pointeur>]])
<Résultat> : Booléen - Vrai si la gravure des fichiers du CD ou DVD a été lancée,
- Faux dans le cas contraire. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo.
Pour savoir si la gravure est terminée, testez l'événement rencontré dans la procédure <Nom de la procédure>.
Remarque : Il est nécessaire qu'un CD ou DVD soit présent dans le graveur. Ce CD/DVD doit contenir assez d'espace pour graver une nouvelle session.
<Options de gravure> : Constante ou combinaison de constantes de type Entier Option de gravure des fichiers sur le CD ou le DVD : | | graveurEjecteAuto | Ouvre le tiroir du graveur à la fin de la gravure. | graveurFinalise | Finalise le média : toute écriture ultérieure sur le média sera interdite. Remarque : Les médias réinscriptibles peuvent tout de même être effacés puis réutilisés. | graveurSansEjecter | N'ouvre pas le tiroir du graveur à la fin de la gravure. | graveurSimule | Simule la gravure du CD ou du DVD. Toutes les étapes de la gravure sont réalisées sauf la gravure effective des fichiers sur le CD/DVD. |
Par défaut, les fichiers sont réellement gravés sur le CD/DVD (pas de simulation) et le tiroir du graveur ne s'ouvre pas à la fin de la gravure. <Procédure WLangage> : Nom de procédure optionnel Nom de la procédure WLangage ("callback") appelée régulièrement lors de la gravure. Cette procédure permet de gérer les différents événements rencontrés. Cette procédure est de la forme :
PROCEDURE <Nom de la procédure>(<Événement rencontré>, <Message événement>, <Pointeur de la procédure>, <Paramètre 1>, <Paramètre 2>) Les paramètres de cette procédure sont optionnels. Il n'est pas nécessaire de passer des paramètres à cette procédure. En effet, ces paramètres sont renseignés automatiquement à chaque fichier traité. <Pointeur> : Entier optionnel Pointeur passé à la procédure <Nom de la procédure>. Remarques Procédure permettant de gérer les différents événements rencontrés La fonction GraveurEnregistre appelle régulièrement la procédure <Nom de la procédure>. Cette procédure permet de gérer les différents événements rencontrés lors de la gravure. Cette procédure est une procédure locale ou globale. Cette procédure doit être déclarée de la façon suivante : PROCEDURE <Nom de la procédure>(<Événement rencontré>, <Message événement>, <Pointeur de la procédure>, <Paramètre 1>, <Paramètre 2>) - <Événement rencontré> est une constante qui indique le type d'événement rencontré.
- <Message événement> est une chaîne de caractères contenant le message correspondant à l'événement rencontré.
- <Pointeur de la procédure> est un entier qui vaut la valeur passé dans le paramètre <Pointeur> de la fonction GraveurEnregistre. Si le paramètre <Pointeur> n'est pas précisé, <Pointeur> vaut 0.
- <Paramètre 1>, <Paramètre 2> sont des entiers qui contiennent une valeur spécifique à l'événement rencontré.
Voici les différentes valeurs pouvant être prises : | | | | | Événement | <Événement rencontré> | <Message événement> | <Paramètre 1> | <Paramètre 2> |
---|
Annulation de la gravure | graveurNotificationAbandon | "" | 0 | 0 | Erreur détectée | graveurNotificationErreur | Message d'erreur | Code de l'erreur rencontrée | 0 | Fermeture du CD/DVD | graveurNotificationFermetureCD | "" | Durée (en secondes) de la fermeture du CD/DVD | 0 | Gravure terminée | graveurNotificationFinGravure | Message d'erreur si <Paramètre 1> différent de 0, chaîne vide ("") dans le cas contraire | Code de retour, 0 si aucune erreur | 0 | Gravure d'un bloc | graveurNotificationGravureBloc | "" | Rang du bloc en cours | Nombre total de blocs à graver | Gravure d'une piste | graveurNotificationGravurePiste | "" | Rang de la piste en cours | Nombre total de pistes à graver | Préparation de la gravure | graveurNotificationPrépareGravure | "" | Durée (en secondes) de la préparation de la gravure | 0 | Autre événement | | Message de l'événement | Rang de l'étape en cours | Nombre total d'étapes à réaliser |
Pour récupérer la valeur du <Pointeur de la procédure>, affectez la valeur du <Pointeur de la procédure> à la valeur du <Pointeur> dans la procédure avec la fonction Transfert. Remarque : Les paramètres de cette procédure sont optionnels : il est possible par exemple de ne spécifier que l'événement et le message. Sessions et pistes Les CD/DVD sont divisés en sessions et en pistes. Une session correspond à l'ensemble des fichiers gravés au cours de la même gravure. Une piste correspond à un fichier. Une session peut contenir une ou plusieurs pistes. Chaque gravure sur le même CD/DVD génère une nouvelle session sur le CD/DVD. Remarque : Dans le cas d'un CD/DVD de type audio, certains lecteurs de CD/DVD peuvent lire uniquement les pistes de la première session. Compilation Une compilation correspond à l'ensemble des fichiers à graver sur un CD ou un DVD. Cette compilation sera prise en compte lors du prochain appel de la fonction GraveurEnregistre. Une compilation est automatiquement supprimée : - soit lors du changement du type du CD/DVD à graver (fonction GraveurTypeMédia).
- soit lors de la sélection du graveur utilisé par défaut (fonction GraveurSélectionne).
- soit après l'appel de la fonction GraveurEnregistre (uniquement si la gravure a été lancée, <Résultat> à Vrai).
- soit lors de l'annulation de la gravure (fonction GraveurAnnuleGravure).
- soit lors de la fermeture de l'application WINDEV ou du site WEBDEV en cours.
CD/DVD gravé de type audio Il n'est pas possible de graver une compilation sur un CD/DVD de type audio déjà gravé. Configuration nécessaire Composante : wd290grv.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|