Compartir a través de

.load, .loadby (Cargar DLL de extensión)

  • Artículo

Los comandos .load y .loadby cargan un nuevo archivo DLL de extensión en el depurador.

.load DLLName  
!DLLName.load 
.loadby DLLName ModuleName

Parámetros

DLLName
Especifica el archivo DLL de extensión del depurador que se va a cargar. Si usa el comando .load, DLLName debe incluir la ruta de acceso completa. Si usa el comando .loadby, DLLName debe incluir solo el nombre de archivo.

ModuleName
Especifica el nombre del módulo de un módulo que se encuentra en el mismo directorio que el archivo DLL de extensión que especifica DLLName.

Entorno

Elemento Descripción
Modos Modo de usuario, modo kernel
Destinos En tiempo real, volcado de errores
Platforms All

Información adicional

Para obtener más información sobre cómo cargar, descargar y controlar extensiones, consulte Carga de archivos DLL de extensión del depurador.

Comentarios

Al usar el comando .load, debe especificar la ruta de acceso completa.

Al usar el comando .loadby, no se especifica la ruta de acceso. En su lugar, el depurador busca el módulo que especifica el parámetro ModuleName, determina la ruta de acceso de ese módulo y, a continuación, usa esa ruta de acceso cuando el depurador carga el archivo DLL de extensión. Si el depurador no encuentra el módulo o si no encuentra el archivo DLL de extensión, recibirá un mensaje de error que especifique el problema. No es necesario que haya ninguna relación entre el módulo especificado y el archivo DLL de extensión. El uso del comando .loadby es simplemente una manera de evitar escribir una ruta de acceso larga.

Una vez completado el comando .load o .loadby, puede acceder a los comandos almacenados en la extensión cargada.

Para cargar un archivo DLL de extensión, puede realizar una de las acciones siguientes:

  • Use el comando .load o .loadby.

  • Ejecute una extensión mediante la emisión del elemento completo !DLLName.ExtensionCommand. Si el depurador aún no ha cargado DLLName.dll, carga el archivo DLL en este momento si se encuentra en la ruta de búsqueda de DLL actual.

Use el comando .chain para mostrar información sobre lo que se ha cargado y la ruta de búsqueda de DLL actual.

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

Por ejemplo, el código administrado SOS.dll no está en la ruta de búsqueda de archivos DLL mostrados anteriormente, por lo que use el comando .load con una ruta de acceso completa para cargar el archivo dll.

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