什么是 __stdcall？

Question

我正在学习 Win32 编程，WinMain 原型如下所示：

int WINAPI WinMain ( HINSTANCE instance, HINSTANCE prev_instance, PSTR cmd_line, int cmd_show )

我对这个 WINAPI 标识符的用途感到困惑，并发现：

#define WINAPI      __stdcall

这是做什么的？ 我对返回类型之后有什么东西感到困惑。 __stdcall 是做什么用的？ 当返回类型和函数名之间存在某些内容时，这意味着什么？

Answer 1

__stdcall 是函数使用的调用约定。 这告诉编译器适用于设置堆栈、推送参数和获取返回值的规则。

还有许多其他调用约定，__cdecl、__thiscall、__fastcall 以及名字奇妙的 __declspec(naked) 。 __stdcall 是 Win32 系统调用的标准调用约定。

维基百科涵盖了详细信息。

当您调用代码之外的函数（例如操作系统 API）或操作系统调用您时（如 WinMain 的情况），这一点尤为重要。 如果编译器不知道正确的调用约定，那么您可能会遇到非常奇怪的崩溃，因为堆栈将无法正确管理。

Answer 2

C 或 C++ 本身不定义这些标识符。 它们是编译器扩展并代表某些调用约定。 这决定了参数的放置位置、顺序、被调用函数将在哪里找到返回地址等等。 例如，__fastcall 意味着函数的参数通过寄存器传递。

维基百科文章 概述了其中发现的不同调用约定。

Answer 3

到目前为止的答案已经涵盖了细节，但是如果您不打算深入汇编，那么您所需要知道的是调用者和被调用者都必须使用相同的调用约定，否则您将遇到以下错误很难找到。

Answer 4

我同意到目前为止所有的答案都是正确的，但原因如下。 Microsoft 的 C 和 C++ 编译器提供了各种调用约定，以提高应用程序的 C 和 C++ 函数中函数调用的（预期）速度。 在每种情况下，调用者和被调用者必须就使用哪种调用约定达成一致。 现在，Windows本身提供了函数（API），并且这些函数已经编译好了，所以当你调用它们时，你必须遵守它们。 对 Windows API 的任何调用以及来自 Windows API 的回调都必须使用 __stdcall 约定。

Answer 5

它与函数的调用方式有关——基本上就是将东西放入堆栈的顺序以及谁负责清理。

这是文档，但除非您理解第一部分，否则它没有多大意义：
http://msdn.microsoft.com/en-us/library/zxk0tw93.aspx

Answer 6

__stdcall 用于将函数参数放入堆栈中。
函数完成后，它会自动释放内存。
这用于固定参数。

void __stdcall fnname ( int, int* )
{
    ...
}

int main()
{
    CreateThread ( NULL, 0, fnname, int, int*...... )
}

这里的fnname有参数，它直接推入堆栈。

Answer 7

直到今天我才用过这个。 这是因为在我的代码中我使用的是多线程，而我使用的多线程 API 是 Windows 的 (_beginthreadex)。

要启动线程：

_beginthreadex(NULL, 0, ExecuteCommand, currCommand, 0, 0);

ExecuteCommand 函数必须在方法签名中使用 __stdcall 关键字，以便 beginthreadex 调用它：

unsigned int __stdcall Scene::ExecuteCommand(void* command)
{
    return system(static_cast<char*>(command));
}