Referencia de línea de comandos de ML y ML64

Ensambla y vincula uno o varios archivos de origen del lenguaje ensamblado. Las opciones de línea de comandos distinguen mayúsculas de minúsculas.

Para obtener más información sobre ml64.exe, vea MASM for x64 (ml64.exe).

Syntax

ML[] options [filename [options] filename]

ML64[] options [filename [options] filename] ... [/linklink_options]

Parámetros

options
Las opciones enumeradas en la tabla siguiente:

Opción Action
/AT Habilita la compatibilidad con el modelo tiny-memory. Habilita mensajes de error para construcciones de código que infringen los requisitos de .com los archivos de formato. Esta opción no es equivalente a la .MODELTINY directiva .
No está disponible en ml64.exe.
/Bl filename Selecciona un enlazador alternativo en filename.
/c Solo se ensambla. No vincula.
/coff Genera el tipo de formato de archivo de objeto común (COFF) del módulo de objetos. Necesario para el desarrollo del lenguaje de ensamblado Win32.
No está disponible en ml64.exe.
/Cp Conserva el caso de todos los identificadores de usuario.
/Cu Asigna todos los identificadores a mayúsculas (valor predeterminado).
No está disponible en ml64.exe.
/Cx Conserva mayúsculas y minúsculas en símbolos públicos y extern.
/D symbol⟦=value⟧ Define una macro de texto con el nombre symbolespecificado. Si value falta, está en blanco. Se deben incluir entre comillas varios tokens separados por espacios.
/EP Genera una lista de origen preprocesada (enviada a STDOUT). Consulte /Sf.
/ERRORREPORT[ NONE | PROMPT | QUEUE | SEND] Deprecated. Los informes de errores se controlan mediante Windows configuración de informes de errores (WER).
/F hexnum Establece el tamaño de la pila en hexnum bytes (igual que /link /STACK:<number>). El valor debe expresarse en notación hexadecimal. Debe haber un espacio entre /F y hexnum.
/Fe filename Asigna un nombre al archivo ejecutable.
/Fl filename⟦⟧ Genera una lista de código ensamblado. Consulte /Sf.
/Fm filename⟦⟧ Crea un archivo de mapa del enlazador.
/Fo filename Asigna un nombre a un archivo de objeto. Para obtener más información, vea Comentarios.
/FPi Genera correcciones del emulador para la aritmética de punto flotante (solo lenguaje mixto).
No está disponible en ml64.exe.
/Fr filename⟦⟧ Genera un archivo de explorador de origen .sbr .
/FR filename⟦⟧ Genera una forma extendida de un archivo del explorador .sbr de origen.
/Gc Especifica el uso de convenciones de estilo FORTRAN o Pascal para las llamadas y nombres de función. Igual a OPTION LANGUAGE:PASCAL.
No está disponible en ml64.exe.
/Gd Especifica el uso de convenciones de estilo C para llamadas y nombres de función. Igual a OPTION LANGUAGE:C.
No está disponible en ml64.exe.
/Gz Especifica el uso de convenciones para las llamadas y nombres de __stdcall función. Igual a OPTION LANGUAGE:STDCALL.
No está disponible en ml64.exe.
/H number Restringe los nombres externos a number caracteres significativos. El valor predeterminado es de 31 caracteres.
No está disponible en ml64.exe.
/help Muestra un resumen de la sintaxis y las opciones de la línea de comandos de ML.
/I pathname Establece la ruta de acceso para el archivo de inclusión. Se permite un máximo de 10 /I opciones.
/nologo Suprime los mensajes para un ensamblado correcto.
/omf Genera el tipo de formato de archivo del módulo de objetos (OMF) del módulo de objetos. /omf implica /c. ML.exe no admite la vinculación de objetos OMF.
No está disponible en ml64.exe.
/quiet Suprime el mensaje "Ensamblado". Disponible en Visual Studio 17.6 y versiones posteriores.
/Sa Activa la lista de toda la información disponible.
/safeseh Marca el archivo de objeto: no contiene controladores de excepciones o contiene controladores de excepciones que se declaran con .SAFESEH.
No está disponible en ml64.exe.
/Sf Agrega la lista de primer paso al archivo de lista.
/Sl width Establece el ancho de línea de la lista de origen en caracteres por línea en width. El intervalo es de 60 a 255 o 0. El valor predeterminado es 0. Igual que PAGEwidth.
/Sn Desactiva la tabla de símbolos cuando se genera una lista.
/Sp length Establece la longitud de página de la lista de origen en líneas por página lengthen . El intervalo es de 10 a 255 o 0. El valor predeterminado es 0. Igual que PAGElength.
/Ss text Especifica el texto de la lista de origen. Igual que SUBTITLE el texto.
/St text Especifica el título de la lista de origen. Igual que TITLE el texto.
/Sx Activa condicionales false en la lista.
/Ta filename Ensambla el archivo de origen cuyo nombre no termina con la .asm extensión.
/unwindv3 Habilita la compatibilidad con la directiva de desenredado experimental Desenredado versión 3. Cuando se especifica, las directivas de desenredado V3 deben aparecer antes de su instrucción asociada (la inversa del comportamiento V1), se requiere la grabación de epílogo a través .BEGINEPILOG/.ENDEPILOG de y la macro @UnwindVersion predefinida devuelve .3 Para obtener más información, vea MASM for x64 (ml64.exe).
Solo está disponible en ml64.exe.
/w Igual a /W0 /WX.
/W level Establece el nivel de advertencia, donde level = 0, 1, 2 o 3.
/WX Si se generan advertencias, devuelve un código de error.
/X Omitir INCLUDE la ruta de acceso del entorno.
/Zd Genera información de número de línea en el archivo de objeto.
/Zf Hace que todos los símbolos son públicos.
/ZH:MD5 Use MD5 para la suma de comprobación en la información de depuración.
/ZH:SHA_256 Use SHA256 para la suma de comprobación en la información de depuración (valor predeterminado en Visual Studio versión 17.0 y posteriores de Visual Studio 2022).
/ZH:SHA384 Use SHA384 para la suma de comprobación en la información de depuración. 18.6.0
/ZH:SHA512 Use SHA512 para la suma de comprobación en la información de depuración. 18.6.0
/Zi Genera información de CodeView en el archivo de objeto.
/Zm Habilita M510 la opción de compatibilidad máxima con MASM 5.1.
No está disponible en ml64.exe.
/Zp alignment⟦⟧ Empaqueta estructuras en el límite de bytes especificado. alignment puede ser 1, 2, 4, 8 o 16.
/Zs Realiza solo una comprobación de sintaxis.
/? Muestra un resumen de la sintaxis y las opciones de la línea de comandos de ML.

18.6.0 Esta opción está disponible a partir de Visual Studio 2026, versión 18.6.0 y MSVC versión 14.51.

filename
El nombre del archivo.

link_options
Opciones de vínculo. Para obtener más información, vea Opciones del enlazador.

Observaciones

Algunas opciones de línea de comandos para ML y ML64 distinguen la ubicación. Por ejemplo, dado que ML y ML64 pueden aceptar varias /c opciones, se deben especificar las opciones correspondientes /Fo antes de /c. En el ejemplo de línea de comandos siguiente se muestra una especificación de archivo de objeto para cada especificación de archivo de ensamblado:

ml.exe /Fo a1.obj /c a.asm /Fo b1.obj /c b.asm

Variables de entorno

Variable Descripción
INCLUDE Especifica la ruta de acceso de búsqueda para los archivos de inclusión.
ML Especifica las opciones de línea de comandos predeterminadas.
TMP Especifica la ruta de acceso de los archivos temporales.

Consulte también

Mensajes de error de ML
Referencia de Macro Assembler de Microsoft

  • Last updated on