Partager via


.load, .loadby (charger la DLL d’extension)

Les commandes .load et .loadby chargent un nouveau DLL d’extension dans le débogueur.

.load DLLName  
!DLLName.load 
.loadby DLLName ModuleName

Paramètres

DLLName
Spécifie la DLL d’extension de débogueur à charger. Si vous utilisez la commande .load, DLLName doit inclure le chemin complet. Si vous utilisez la commande .loadby, DLLName doit inclure uniquement le nom de fichier.

ModuleName
Spécifie le nom du module qui se trouve dans le même répertoire que la DLL d’extension spécifiée par DLLName.

Environnement

Élément Description
Modes Mode utilisateur, mode noyau
Targets Live, vidage de la mémoire
Platforms Tous

Informations supplémentaires

Pour plus d’informations sur les façons de charger, de décharger et de contrôler les extensions, consultez la page Chargement des DLL d’extension de débogueur.

Notes

Lorsque vous utilisez la commande .load, vous devez spécifier le chemin d’accès complet.

Lorsque vous utilisez la commande .loadby, vous n’avez pas besoin de spécifier le chemin d’accès. Au lieu de cela, le débogueur recherche le module spécifié par le paramètre ModuleName, détermine le chemin d’accès de ce module, puis utilise ce chemin lorsque le débogueur charge la DLL d’extension. Si le débogueur ne trouve pas le module ou la DLL d’extension, un message d’erreur s’affiche et précise le problème. Il n’est pas nécessaire d’avoir une relation entre le module spécifié et la DLL d’extension. La commande .loadby est donc surtout utilisée pour éviter de taper un chemin long.

Une fois la commande .load ou .loadby terminée, vous pouvez accéder aux commandes stockées dans l’extension chargée.

Pour charger un DLL d’extension, vous pouvez effectuer l’une des opérations suivantes :

  • Utilisez la commande .load ou .loadby.

  • Exécutez une extension en émettant l’intégralité de la syntaxe !DLLName.ExtensionCommand. Si le débogueur n’a pas encore chargé DLLName.dll, il charge alors la DLL si elle se trouve dans le chemin de recherche de DLL actuel.

Utilisez la commande .chain pour afficher des informations sur ce qui a été chargé et sur le chemin de recherche de DLL actuel.

0:000> .chain
Extension DLL search Path:
    C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\WINXP;C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\winext;C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\winext\arcade;C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\pri;C:\Program Files (x86)\Windows Kits\10\Debuggers\x64;
Extension DLL chain:
    C:\Windows\Microsoft.NET\Framework64\v4.0.30319\SOS.dll: image 4.8.4084.0, API 1.0.0, built Sun Nov 24 00:38:52 2019

Par exemple, le code géré SOS.dll n’est pas dans le chemin de recherche pour les DLL indiquées ci-dessus. Utilisez la commande .load avec un chemin d’accès complet pour charger cette DLL.

0:000> .load C:\Windows\Microsoft.NET\Framework64\v4.0.30319\SOS.dll