PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • 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
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
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> [, <Nom de la procédure> [, <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 :
graveurEjecteAutoOuvre le tiroir du graveur à la fin de la gravure.
Versions 16 et supérieures
graveurFinalise
Nouveauté 16
graveurFinalise
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.
graveurSansEjecterN'ouvre pas le tiroir du graveur à la fin de la gravure.
graveurSimuleSimule 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.
<Nom de la procédure> : Chaîne de caractères optionnelle (avec ou sans guillemets)
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 gravuregraveurNotificationAbandon""00
Erreur détectéegraveurNotificationErreurMessage d'erreurCode de l'erreur rencontrée0
Fermeture du CD/DVDgraveurNotificationFermetureCD""Durée (en secondes) de la fermeture du CD/DVD0
Gravure terminéegraveurNotificationFinGravureMessage d'erreur si <Paramètre 1> différent de 0, chaîne vide ("") dans le cas contraireCode de retour, 0 si aucune erreur0
Gravure d'un blocgraveurNotificationGravureBloc""Rang du bloc en coursNombre total de blocs à graver
Gravure d'une pistegraveurNotificationGravurePiste""Rang de la piste en coursNombre total de pistes à graver
Préparation de la gravuregraveurNotificationPrépareGravure""Durée (en secondes) de la préparation de la gravure0
Autre événement Message de l'événementRang de l'étape en coursNombre 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 créée lors du premier appel de la fonction GraveurAjouteFichier ou de la fonction GraveurAjouteRépertoire. Une seule compilation à la fois peut être créée.
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

WINDEV La gravure de CD est disponible uniquement sous Windows XP et supérieur. La gravure de DVD est disponible sous Windows Vista, et sous Windows XP en utilisant la mise à jour KB932716 pour Windows XP (cette mise à jour doit être téléchargée depuis le site de Microsoft et installée car elle n'est pas prise en compte par le mécanisme de Live Update).
WEBDEV - Code Serveur La gravure de CD et DVD sera réalisée sur le serveur Web. Pour graver des CD ou des DVD, le serveur doit être sous Windows XP ou supérieur. Pour graver des CD sous Windows 2003 Serveur, il est nécessaire d'activer le service de gravure IMAPI (nommée "Service COM de gravage de CD IMAPI"). Pour graver des DVD sous Windows 2003 Serveur, il est nécessaire d'installer en plus la mise à jour KB932716.
Composante : wd240grv.dll
Version minimum requise
  • Version 10
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire