MQL5 · Avancé
Importer des DLL en MQL5 : la directive #import, les types autorisés et les risques
Appeler une fonction de l’API Windows ou d’une bibliothèque C++ maison depuis un EA : syntaxe de #import, ordre de recherche des DLL, passage de tableaux et de chaînes, autorisation dans le terminal et interdiction sur le Market.
Pour appeler une fonction d’une DLL Windows depuis MQL5, déclarez son prototype entre deux directives #import : #import "nom.dll", la ou les déclarations de fonctions, puis un #import seul qui ferme le bloc. Le compilateur connaît alors la signature et vous appelez la fonction comme une fonction MQL5 ordinaire. Deux conditions s’ajoutent à l’exécution : l’importation de DLL doit être autorisée dans le terminal (globalement dans les options, ou dans les propriétés du programme), et la DLL doit être trouvée dans l’un des dossiers de recherche, idéalement MQL5\Libraries. Les DLL ouvrent l’accès à tout le système : c’est leur force et leur principal danger.
Cette page appartient à la rubrique MQL5 avancé. Elle complète la page #include, #define et #property, qui présente les autres directives du préprocesseur. Avant de recourir à une DLL, demandez-vous si une fonction native ne suffit pas : WebRequest pour HTTP, les fonctions Database pour SQLite, les fichiers pour les échanges de données, ONNX pour l’apprentissage automatique.
La syntaxe de #import
Un bloc d’import contient la description complète de chaque fonction : type de retour, nom et paramètres. Le même mécanisme sert aussi à importer des fonctions d’une bibliothèque MQL5 compilée (.ex5). La documentation officielle montre un bloc par module :
#import "stdlib.ex5"pour une bibliothèque MQL5 ;#import "ExpertSample.dll"pour une DLL ;- un
#importsans nom pour fermer le bloc.
La documentation déconseille d’indiquer un chemin complet vers le module. Placez plutôt la DLL dans MQL5\Libraries et importez-la par son seul nom.
Où le terminal cherche la DLL
Si la DLL n’est pas déjà chargée (par un autre programme, par exemple), le terminal la cherche dans cet ordre :
- le dossier depuis lequel le module qui importe la DLL a été lancé ;
- le dossier
MQL5\Librariesdu répertoire de données du terminal ; - le dossier depuis lequel le terminal MetaTrader 5 a été lancé ;
- le dossier système ;
- le dossier Windows ;
- le dossier courant ;
- les dossiers listés dans la variable d’environnement
PATH.
Si une DLL du même nom est déjà chargée, c’est elle qui est utilisée. Cela peut créer des surprises quand deux versions d’une même DLL coexistent : donnez à vos DLL des noms explicites et versionnés.
Les types que l’on peut passer
Le passage de paramètres obéit à des règles strictes, issues de la documentation :
- les pointeurs (
*) ne peuvent pas être utilisés comme paramètres ; - les classes, les tableaux de chaînes et les objets complexes contenant des chaînes ou des tableaux dynamiques ne peuvent pas être transmis à une fonction importée d’une DLL ;
- les références à des objets contenant des tableaux dynamiques ou des pointeurs sont interdites.
Restent les types simples (int, long, double, uchar…), les chaînes et les tableaux de types simples. Un tableau passé par référence (double &arr[]) arrive côté C/C++ sous la forme d’un pointeur vers ses données ; passez toujours sa taille dans un paramètre séparé. Les chaînes MQL5 sont en Unicode (UTF-16) : avec l’API Windows, utilisez les variantes « W » des fonctions (MessageBoxW et non MessageBoxA).
Côté architecture, la documentation indique que lorsqu’une fonction diffère entre versions 32 et 64 bits de Windows, il faut importer les deux et choisir à l’exécution grâce à la variable _IsX64. Le terminal MetaTrader 5 actuel étant une application 64 bits, vos propres DLL doivent être compilées en x64. Attention aussi aux types de taille variable : un handle de fenêtre Windows occupe 8 octets en 64 bits, déclarez-le en long.
Exemple : une fonction de l’API Windows et une DLL maison
Le script ci-dessous importe deux fonctions système, puis montre la déclaration d’une fonction de DLL maison qui reçoit un tableau.
//+------------------------------------------------------------------+
//| DllDemo.mq5 : import de fonctions de DLL |
//+------------------------------------------------------------------+
//--- 1. API Windows : variantes Unicode (W) car les chaînes MQL5 sont en UTF-16
#import "user32.dll"
int MessageBoxW(long hwnd,string text,string caption,uint type);
#import "kernel32.dll"
uint GetCurrentProcessId(void);
#import
//--- 2. DLL maison placée dans MQL5\Libraries (compilée en x64)
// Côté C++ :
// extern "C" __declspec(dllexport) double __stdcall SumArray(const double *data,int size)
// { double s=0; for(int i=0;i<size;i++) s+=data[i]; return s; }
#import "MyMath.dll"
double SumArray(const double &data[],int size); // le tableau arrive en pointeur
#import
#define MB_OK 0x00000000 // constante Windows
void OnStart()
{
//--- vérifier que l'import de DLL est autorisé pour ce programme
if(!MQLInfoInteger(MQL_DLLS_ALLOWED))
{
Print("L'import de DLL n'est pas autorisé : cochez l'option dans les propriétés");
return;
}
PrintFormat("PID du terminal : %u",GetCurrentProcessId());
double closes[];
int n=CopyClose(_Symbol,PERIOD_CURRENT,1,100,closes);
if(n>0)
{
// décommentez si MyMath.dll est présente dans MQL5\Libraries
// PrintFormat("Moyenne calculée par la DLL : %.5f",SumArray(closes,n)/n);
PrintFormat("%d clôtures prêtes à transmettre à la DLL",n);
}
MessageBoxW(0,"Import de DLL réussi","DllDemo",MB_OK);
}
Le contrôle MQLInfoInteger(MQL_DLLS_ALLOWED) permet d’afficher un message clair au lieu d’un arrêt brutal. Selon la documentation, si l’usage des DLL est interdit, l’Expert Advisor est arrêté avec un message dans le journal et reste arrêté jusqu’à sa réinitialisation (recompilation, ou validation de ses propriétés).
Autoriser les DLL dans le terminal
L’autorisation se donne à deux niveaux : globalement, dans Outils, Options, onglet Expert Advisors, avec l’option d’autorisation de l’importation de DLL ; et programme par programme, dans la fenêtre de propriétés qui s’ouvre lorsque vous attachez l’EA au graphique. Une bonne pratique consiste à laisser l’option globale désactivée et à n’autoriser que les programmes dont vous connaissez la provenance. Sur un VPS ou une machine partagée, documentez cette configuration : elle fait partie du déploiement au même titre que les paramètres de l’EA, comme le rappelle la checklist avant mise en production.
Sécurité : la vraie question
Une DLL s’exécute avec les droits du terminal, hors du bac à sable de MQL5. Elle peut lire et écrire n’importe quel fichier accessible à l’utilisateur, ouvrir des connexions réseau, lancer des processus. Une DLL fournie par un tiers peut donc dérober des identifiants ou modifier des fichiers. Règles de prudence :
- n’autorisez jamais une DLL dont vous n’avez pas le code source ou une source de confiance ;
- compilez vous-même vos DLL et conservez leur code sous gestion de versions, par exemple avec MQL5 Algo Forge ;
- gardez l’interface minimale : quelques fonctions aux types simples, sans allocation mémoire partagée entre les deux côtés ;
- un plantage dans la DLL peut faire tomber tout le terminal, avec tous les EA qu’il exécute.
DLL et Market : incompatibles
Les règles du Market MQL5 sont sans ambiguïté : les produits ne doivent contenir aucun appel à une DLL, y compris aux bibliothèques système de Windows. Si vous visez une publication, concevez votre programme sans DLL dès le départ, comme l’explique Publier un produit sur le Market MQL5. Les besoins courants ont presque toujours un équivalent natif : WebRequest pour le réseau, SQLite pour les données, ONNX pour les modèles, les classes Canvas pour le graphisme.
Pièges fréquents
- DLL 32 bits : elle ne se charge pas dans un terminal 64 bits.
- Convention d’appel ou décoration des noms : exportez en
extern "C"pour éviter que le compilateur C++ ne modifie le nom de la fonction. - Taille de tableau oubliée : la DLL ne connaît pas la taille d’un tableau MQL5 ; transmettez-la toujours.
- Chaînes ANSI : une fonction « A » de l’API Windows reçoit une chaîne Unicode mal interprétée ; utilisez la variante « W ».
- Mise à jour à chaud : une DLL chargée reste verrouillée tant que le terminal la référence ; fermez les programmes qui l’utilisent avant de la remplacer.
Questions fréquentes
Où placer ma DLL pour que MQL5 la trouve ?
Dans le dossier MQL5\Libraries du répertoire de données du terminal. C’est le deuxième emplacement parcouru, juste après le dossier du module importateur, et le plus prévisible. Évitez les chemins complets dans #import.
Pourquoi mon EA s’arrête-t-il dès qu’il appelle la DLL ?
Le plus souvent parce que l’importation de DLL n’est pas autorisée pour ce programme. Activez l’option dans les propriétés de l’EA ou dans Outils, Options, Expert Advisors. Vérifiez aussi que la DLL est bien compilée en 64 bits et présente dans un dossier de recherche.
Peut-on passer une structure à une DLL ?
Oui pour une structure simple, composée uniquement de types de base de taille fixe. Les structures contenant des chaînes, des tableaux dynamiques ou des pointeurs, ainsi que les classes, ne peuvent pas être transmises.
Un EA utilisant une DLL peut-il être vendu sur le Market ?
Non. Les règles du Market interdisent tout appel à une DLL, y compris aux bibliothèques système de Windows. Il faut remplacer la DLL par des fonctions natives de MQL5.
- Programmation orientée objet : classes
- Héritage et polymorphisme
- La bibliothèque standard
- Matrices et vecteurs
- Modèles ONNX dans MQL5
- Le module Python MetaTrader5
- Lire et écrire des fichiers CSV
- Bases de données SQLite
- WebRequest et API externes
- Le calendrier économique en MQL5
- Profiler et optimiser son code
- Versionner son code (MQL5 Algo Forge)
- Publier un produit sur le Market MQL5
