DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions Graveur de CD et DVD
  • Procédure permettant de gérer les différents événements rencontrés
  • Configuration nécessaire
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
GraveurEfface (Fonction)
En anglais : BurnerErase
Efface les fichiers présents sur un CD ou DVD réinscriptible. Ce CD (ou DVD) doit être présent dans le graveur en cours.
Lors de l'effacement, la fonction GraveurEfface 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 l'effacement.
Remarques :
  • Le graveur à utiliser peut être sélectionné grâce à la fonction GraveurSélectionne.
  • L'utilisation de cette fonction n'est pas bloquante. Pour savoir si l'effacement est terminé, utilisez la procédure WLangage appelée régulièrement par la fonction GraveurEfface.
// Effacer complètement les fichiers présents sur le CD
// Le tiroir du graveur s'ouvrira automatiquement Ã  la fin de l'effacement
ResEfface est un booléen 
ResEfface = GraveurEfface(graveurEffacementComplet + graveurEjecteAuto, ProcEffacementCD)
// Pour visualiser cet exemple en totalité, cliquez sur le lien "Exemple"
Syntaxe
<Résultat> = GraveurEfface([<Option d'effacement> [, <Procédure WLangage> [, <Pointeur>]]])
<Résultat> : Booléen
  • Vrai si l'effacement des fichiers du CD/DVD a été lancé,
  • Faux dans le cas contraire. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo.
Pour savoir si l'effacement est terminé, testez l'événement rencontré dans la procédure <Nom de la procédure>.
<Option d'effacement> : Constante ou combinaison de constantes optionnelle de type Entier
Option d'effacement des fichiers du CD ou DVD :
graveurEffacementCompletEffacement complet : les fichiers sont réellement supprimés du CD/DVD.
Cette méthode peut être longue mais les fichiers supprimés ne pourront pas être restaurés.
graveurEffacementRapideEffacement rapide : les fichiers ne sont pas totalement supprimés du CD/DVD. Seules les références au contenu du CD sont supprimées.
Cette méthode est plus rapide, cependant il sera possible de restaurer les fichiers effacés grâce à un logiciel spécialisé. Cette méthode est donc déconseillée si les fichiers du CD/DVD contiennent des informations confidentielles.
graveurEjecteAutoOuverture du tiroir du graveur à la fin de l'effacement.
graveurSansEjecterLe tiroir du graveur ne s'ouvre pas à la fin de l'effacement.
Par défaut, l'effacement est rapide et le tiroir du graveur ne s'ouvre pas automatiquement à la fin de l'effacement.
<Procédure WLangage> : Nom de procédure optionnelle
Nom de la procédure WLangage ("callback") appelée régulièrement lors de l'effacement. 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>)
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 GraveurEfface 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 l'effacement. 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>)
  • <É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ée dans le paramètre <Pointeur> de la fonction GraveurEfface. Si le paramètre <Pointeur> n'est pas précisé, <Pointeur> vaut 0.
  • <Paramètre> est un entier qui contient 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>
    Annulation de l'effacementgraveurNotificationAbandon""0
    Effacement (disponible uniquement sous Vista ou Windows XP + KB032716)graveurNotificationEffacement""Dans ce cas, deux paramètres sont gérés :
    Paramètre 1 : Nombre de secondes écoulées depuis le début de l'effacement.
    Paramètre 2 : Estimation de la durée totale de l'opération (peut varier pendant l'effacement)
    Attention : Ces informations sont renvoyées par le graveur et peuvent être erronées.
    Erreur détectéegraveurNotificationErreurMessage d'erreurCode de l'erreur rencontrée
    Effacement terminégraveurNotificationFinEffacementMessage d'erreur si <Paramètre> différent de 0, chaîne vide ("") dans le cas contraireCode de retour, 0 si aucune erreur
    Autre événementMessage de l'événement0

    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.

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é "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 : wd290grv.dll
Version minimum requise
  • Version 10
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale