Création et utilisation de DLL dans mIRC

Comme beaucoup d'autres langages intégrés, le mIRC scripting ne permet pas de faire tout ce que l'on désire. En effet le mIRC script permet de faire beaucoup d'actions sur la gestion des évènements IRC, mais dès que l'on veut faire quelque chose d'un peu compliqué on est vite freiné.

Pour pallier ces petits inconvénients, mIRC dispose de différentes solutions, à savoir le DDE (communication interprocessus) et le couplage avec une DLL. Nous allons ici parler des DLL qui permettent d'ouvrir un monde infini sur les possibilités d'options de vos scripts.

Qu'est-ce qu'une DLL (Dynamic Link Library) ?

Microsoft définit une DLL comme un module qui contient des données et des fonctions. Une DLL est chargée en mémoire par un programme appelant (.exe) ou bien par une autre bibliothèque (.dll). En ce sens, il y a deux types de fonctions dans une bibliothèque, les internal et external.

• external : ces fonctions peuvent être appelées par n'importe quel module ;
• internal : ces fonctions ne sont accessibles que par le module appelant.

Avant de développer une DLL, il serait quand même judicieux de savoir comment faire pour utiliser celle-ci. Il n'y a besoin d'aucune manipulation pour charger une DLL dans mIRC, le simple fait de l'appeler par la fonction du script la charge automatiquement.
Il y a deux possibilités d'appeler une DLL :

/dll <nomDeLaDLL> <fonction> <paramètres>

$dll(<nomDeLaDLL>, <fonction>, <paramètres>)

Attention : il y a une différence fondamentale entre ces deux appels. Le premier ne permet pas de récupérer la valeur de retour, tandis que l'autre oui.

var %result = $dll(maDLL.dll,maJolieFonctionQuiRetourne,parametres)

Ensuite concernant la mise en mémoire de la DLL, soit elle reste en mémoire soit elle attend que mIRC la décharge. Au bout de 10 min d'inactivité, mIRC essaye de décharger la DLL de la mémoire. Encore une fois, c'est la DLL qui va décider de ce qu'elle veut faire.
Voici un bout de code très connu qui permet de lister toutes les DLL chargées.

//var %c = $dll(0) | while %c { echo -a $dll(%c) | dec %c }

Si vous voulez forcer une DLL à être déchargée, utilisez l'option -u. Pour décharger toutes les DLL :

//var %c = $dll(0) | while %c { dll -u $dll(%c) | dec %c }

En ce qui concerne les conventions de nommage, il n'en existe pas vraiment… Tout cela est laissé à l'appréciation du développeur. [Petite parenthèse : je profite de ce moment pour vous conseiller de bien réfléchir lors de la conception de votre DLL pour les noms des fonctions de celle-ci.]

III-A. Généralités et bases▲

fonction(HWND mWnd, HWND aWnd, char *data, char *params, BOOL print, BOOL nopause)

III-B. Implémentation PureBasic▲

ProcedureDLL HelloWorld(mWnd, aWnd, *StringData, *StringParam, show.b, nopause.b)
  ;ici on récupère les paramètres envoyés via $dll()
  host$ = PeekS(*StringData)
  
  ;ici on place la chaine dans le tube de sortie
  PokeS(*StringData, "HelloWorld ! Arguments DLL :" + host$) 
  
  ; on retourne 3 car il a un retour dans *StringData
  ProcedureReturn 3 
EndProcedure

/testDLL {
    set %param coucou!
    echo -a $dll(hello.dll, HelloWorld, %param) 
}

III-C. Implémentation C++▲

int __stdcall WINAPI HelloWorld(HWND mWnd, HWND aWnd, char *data, char *parms, BOOL print, BOOL nopause)
{
    char *args;
    args = malloc(sizeof(char) * strlen(data) + 1);
    
    strcpy(args, data); // copie des arguments dans une variable tampon
    strcpy(data,strcat("HelloWorld ! Arguments : ", args)); // copie dans le tube de sortie
    
    return 3; // on annonce à mIRC qu'il y a des infos à retourner
}

LIBRARY NomDeLaDLL
EXPORTS
fonction1
fonction2
...

LIBRARY hello
EXPORTS
HelloWorld

Nous voici arrivés à la fin de notre article. Vous avez donc compris qu'il est très simple de fabriquer une DLL pour optimiser les performances et faire des choses que ne permet pas le mIRC script.
Un des exemples classiques est la gestion de la 3D pour les intros, ou encore les possibilités graphiques (docking de popups…).
J'espère que cet article vous aura intéressé, n'hésitez pas à me faire des commentaires sur le forum ou à poser des questions sur vos développements.

J'adresse ici tous mes remerciements à l'équipe de rédaction de « developpez.com » pour le temps qu'ils ont bien voulu passer à la correction et à l'amélioration de cet article.
Plus particulièrement à mavina et Swoög pour leur aide et Etanne pour la relecture.