|
|
|
|
- Procédure permettant de gérer les différents événements rencontrés
- Configuration nécessaire
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.
ResEfface est un booléen
ResEfface = GraveurEfface(graveurEffacementComplet + graveurEjecteAuto, ProcEffacementCD)
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 : | | graveurEffacementComplet | Effacement 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. | graveurEffacementRapide | Effacement 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. | graveurEjecteAuto | Ouverture du tiroir du graveur à la fin de l'effacement. | graveurSansEjecter | Le 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'effacement | graveurNotificationAbandon | "" | 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ée | graveurNotificationErreur | Message d'erreur | Code de l'erreur rencontrée | Effacement terminé | graveurNotificationFinEffacement | Message d'erreur si <Paramètre> différent de 0, chaîne vide ("") dans le cas contraire | Code de retour, 0 si aucune erreur | Autre événement | | Message de l'événement | 0 |
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
Composante : wd290grv.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|