__stdcall 呼叫慣例會用來呼叫 Win32 API 函式。 被呼叫端會清除堆疊,因此編譯器會建立 vararg 函式 __cdecl。 使用這個呼叫慣例的函式需要函式原型。
__stdcall 修飾元是 Microsoft 專屬的修飾元。
語法
return-type
__stdcallfunction-name[(argument-list)]
auto__stdcallfunction-name[(argument-list)] [->return-type ]
備註
下列清單會顯示這個呼叫慣例的實作。
| 元素 | 實作 |
|---|---|
| 引數傳遞順序 | 由右至左。 |
| 引數傳遞慣例 | 以傳值方式,除非傳遞指標或參考類型。 |
| 堆疊維護責任 | 被呼叫函式會從堆疊快顯其本身的引數。 |
| 名稱裝飾慣例 | 名稱前面會加底線 (_)。 名稱後面加上 @ 符號 (@),再接著引數清單中的位元組數目 (十進位)。 因此,宣告為 int func( int a, double b ) 的函式會裝飾為如下:_func@12 |
| 大小寫轉譯慣例 | 無 |
/Gz 編譯器選項會為所有未以不同呼叫慣例明確宣告的函式指定 __stdcall。
為了與舊版相容,除非指定了編譯器選項 __stdcall,否則 /Za 是 的同義字。
使用 __stdcall 修飾元宣告的函式會傳回值,與使用 __cdecl 宣告的函式相同。
在 ARM 和 x64 處理器上,編譯器會接受並忽略 __stdcall;在 ARM 和 x64 結構上,依照慣例,引數會盡可能在暫存器中傳遞,而後續引數會在堆疊上傳遞。
對於非靜態類別函式,如果函式是以非正規的方式定義,則不需要在非正規定義上指定呼叫慣例修飾詞。 也就是說,對於類別非靜態成員方法而言,宣告時所指定的呼叫慣例是在定義時假設。 如果已指定此類別定義,
struct CMyClass {
void __stdcall mymethod();
};
this
void CMyClass::mymethod() { return; }
相當於這個
void __stdcall CMyClass::mymethod() { return; }
範例
在下列範例中,使用 __stdcall 會導致將所有 WINAPI 函式類型被當成標準呼叫處理:
// Example of the __stdcall keyword
#define WINAPI __stdcall
// Example of the __stdcall keyword on function pointer
typedef BOOL (__stdcall *funcname_ptr)(void * arg1, const char * arg2, DWORD flags, ...);