/Gd, /Gr, /Gv, /Gz (Convención de llamada)

  • Artículo

Estas opciones determinan el orden en el que se insertan los argumentos de función en la pila, si la función de llamador o de llamada quita los argumentos de la pila al final de la llamada y la convención de decoración de nombres que el compilador usa para identificar funciones individuales.

Sintaxis

/Gd
/Gr
/Gv
/Gz

Comentarios

/Gd, la configuración predeterminada, especifica la convención de llamada __cdeclpara todas las funciones excepto las funciones miembro de C++ y las funciones que se marcan como __stdcall , __stdcall o __vectorcall.

/Gr especifica la convención de llamada __fastcall para todas las funciones, excepto las funciones miembro de C++, las funciones denominadas main y las funciones que se marcan como __cdecl, __stdcall o __vectorcall. Todas las funciones __fastcall deben tener prototipos. Esta convención de llamada solo está disponible en los compiladores destinados a x86 y la pasan por alto los compiladores que tienen como destino otras arquitecturas.

/Gz especifica la convención de llamada __stdcall para todas las funciones, excepto las funciones miembro de C++, las funciones denominadas main y las funciones que se marcan como __cdecl, __fastcall o __vectorcall. Todas las funciones __stdcall deben tener prototipos. Esta convención de llamada solo está disponible en los compiladores destinados a x86 y la pasan por alto los compiladores que tienen como destino otras arquitecturas.

/Gvespecifica la convención de llamada __vectorcall para todas las funciones, excepto las funciones miembro de C++, las funciones denominadas main, las funciones con una lista de argumentos de variable vararg o las funciones que se marcan con un atributo __cdecl, __stdcall o __fastcall en conflicto. Esta convención de llamada solo está disponible en las arquitecturas de x86 y x64 que admiten /arch:SSE2 y versiones posteriores, y la pasan por alto los compiladores que tienen como destino la arquitectura ARM.

Las funciones que toman un número variable de argumentos deben marcarse con __cdecl.

/Gd, /Gr, /Gv y /Gz no son compatibles con /clr:safe o /clr:pure. Las opciones del compilador /clr:pure y /clr:safe han quedado en desuso en Visual Studio 2015 y no se admiten en Visual Studio 2017 y versiones posteriores.

Nota:

De manera predeterminada para los procesadores x86, las funciones miembro de C++ usan __thiscall.

Para todos los procesadores, una función miembro que se marca explícitamente como __cdecl, __fastcall, __vectorcall o __stdcall usa la convención de llamada especificada si no se omite en esa arquitectura. Una función miembro que toma un número variable de argumentos siempre usa la convención de llamada __cdecl.

Estas opciones del compilador no tienen ningún efecto en la decoración de nombre de los métodos y las funciones de C++. A menos que se declare como extern "C", los métodos y las funciones de C++ usan un esquema de decoración de nombres diferente. Para más información, vea Nombres decorados.

Si quiere saber más sobre las convenciones de llamada, vea Convenciones de llamada.

Especificaciones de __cdecl

En los procesadores x86, todos los argumentos de función se pasan a la pila de derecha a izquierda. En las arquitecturas de ARM y x64, algunos argumentos los pasa el registro y el resto se pasan a la pila de derecha a izquierda. La rutina de llamada extraen los argumentos de la pila.

Para C, la convención de nomenclatura __cdecl usa el nombre de función precedido por un carácter de subrayado (_); no se realiza ninguna conversión de mayúsculas. A menos que se declaren como extern "C", las funciones de C++ usan un esquema de decoración de nombres diferente. Para más información, vea Nombres decorados.

Especificaciones de __fastcall

Parte de los argumentos de una función __fastcall se pasan en registros (para procesadores x86, ECX y EDX), y el resto se insertan en la pila de derecha a izquierda. La rutina de llamada extrae estos argumentos de la pila antes de devolver resultados. Por lo general, /Gr reduce el tiempo de ejecución.

Nota:

Tenga cuidado al usar la convención de llamada __fastcall para cualquier función que esté escrita en lenguaje ensamblador alineado. El uso de registros podría entrar en conflicto con el uso del compilador.

Para C, la convención de nomenclatura __fastcall usa el nombre de la función precedido por un signo de arroba (@), seguido del tamaño de los argumentos de la función en bytes. No se realiza ninguna conversión de mayúsculas y minúsculas. El compilador usa esta plantilla para la convención de nomenclatura:

@function_name@number

Cuando use la convención de nomenclatura __fastcall, use los archivos de inclusión estándar. En caso contrario, obtendrá referencias externas sin resolver.

Especificaciones de __stdcall

Los argumentos de la función __stdcall se insertan en la pila de derecha a izquierda y la función a la que se ha llamado extrae estos argumentos de la pila antes de devolver resultados.

Para C, la convención de nomenclatura __stdcall usa el nombre de la función precedido por un carácter de subrayado (_ seguido de un signo de arroba @) y del tamaño de los argumentos de la función en bytes. No se lleva a cabo la traducción de mayúsculas y minúsculas. El compilador usa esta plantilla para la convención de nomenclatura:

_functionname@number

Especificaciones de __vectorcall

Los argumentos de entero de la función __vectorcall se pasan por el valor, usando hasta dos (en x86) o cuatro (en x64) registros de enteros y hasta seis registros de XMM para los valores de punto flotante y de vectores; el resto se pasa a la pila de derecha a izquierda. La función a la que se ha llamado limpia la pila antes de devolver resultados. Los valores devueltos del vector y el punto flotante se devuelven en XMM0.

Para C, la convención de nomenclatura __vectorcall usa el nombre de la función seguido de dos signos de arroba (@@) y del tamaño de los argumentos de la función en bytes. No se lleva a cabo la traducción de mayúsculas y minúsculas. El compilador usa esta plantilla para la convención de nomenclatura:

functionname@@number

Para establecer esta opción del compilador en el entorno de desarrollo de Visual Studio

  1. Abra el cuadro de diálogo Páginas de propiedades del proyecto. Para más información, vea Establecimiento del compilador de C++ y de propiedades de compilación en Visual Studio.

  2. Seleccione en la página de propiedades Propiedades de configuración>C/C++>Avanzado.

  3. Modifique la propiedad Convención de llamada.

Para establecer esta opción del compilador mediante programación

Consulte también