/Gd、/Gr、/Gz(调用约定)

这些选项用于确定函数参数入栈的顺序,调用结束时调用方函数或被调用函数是否从堆栈中移除参数,以及编译器用来标识各个函数的名称修饰约定。

/Gd
/Gr
/Gz

备注

备注

这些编译器选项仅在面向 x86 的编译器中可用,它们在面向 x64 或 Itanium 的编译器中不可用。

/Gd 为默认设置,为除 C++ 成员函数和标记为 __stdcall__fastcall 的函数以外的所有函数指定 __cdecl 调用约定。

/Gr 为除 C++ 成员函数和标记为 __cdecl 或 __stdcall 的函数以外的所有函数指定 __fastcall 调用约定。 所有 __fastcall 函数必须具有原型。

/Gz 为除 C++ 成员函数和标记为 __cdecl 或 __fastcall 的函数以外的所有函数指定 __stdcall 调用约定。 所有 __stdcall 函数必须具有原型。

参数个数可变的函数必须标记为 __cdecl。

/Gd/Gr/Gz/clr:safe/clr:pure 不兼容。

备注

对于 x86 处理器,默认情况下 C++ 成员函数使用 __thiscall

对于所有处理器,显式标记为 __cdecl、__fastcall 或 __stdcall 的成员函数使用指定的调用约定。 采用的参数个数可变的成员函数总是使用 __cdecl 调用约定。

__cdecl 细节

对于 C,__cdecl 命名约定使用前面带下划线 (_) 的函数名;不执行任何大小写转换。 除非声明为 extern "C",否则 C++ 函数将使用不同的名称修饰方案。 有关更多信息,请参见 修饰名

__fastcall 细节

__fastcall 函数的一些参数传入寄存器(对于 x86 处理器,为 ECX 和 EDX),而其余的参数按从右向左的顺序入栈。 被调用例程在返回之前从堆栈中弹出这些参数。 通常,/Gr 将缩短执行时间。

备注

在对用内联程序集语言编写的任何函数使用 __fastcall 调用约定时,一定要小心。您对寄存器的使用可能与编译器对它们的使用发生冲突。

对于 C,__fastcall 命名约定使用前面带“at”符 (@) 的函数名,后跟函数参数大小(以字节为单位)。 不执行任何大小写转换。 编译器使用下列命名约定模板:

@function_name@number

当使用 __fastcall 命名约定时,请使用标准包含文件。 否则将获取无法解析的外部引用。

__stdcall 细节

__stdcall 函数的参数被从右到左推送到堆栈上,被调用函数在返回之前从堆栈中弹出这些参数。

对于 C,__stdcall 命名约定使用前面带下划线 (_) 的函数名,后跟“at”符 (@) 和函数的参数大小(以字节为单位)。 不执行任何大小写转换。 编译器使用下列命名约定模板:

_functionname@number

x86 特定

此选项对 C++ 方法和函数的名称修饰无效。 除非声明为 extern "C",否则 C++ 方法和函数将使用不同的名称修饰方案。 有关更多信息,请参见 修饰名

有关调用约定的更多信息,请参见 调用约定

END x86 Specific

在 Visual Studio 开发环境中设置此编译器选项

  1. 打开项目的**“属性页”**对话框。 有关详细信息,请参见如何:打开项目属性页

  2. 单击**“C/C++”**文件夹。

  3. 单击**“高级”**属性页。

  4. 修改**“调用约定”**属性。

以编程方式设置此编译器选项

请参见

参考

编译器选项

设置编译器选项