【Win32笔记一】Windows程式关键字

1. HINSTANCE （实例句柄，应用程序） HWND（窗口句柄） 都是句柄，本质是一样的，只是从名字区分一下，它们都是handle


2. #define WINAPI __stdcall
    __stdcall 被这个关键字修饰的函数，其参数都是从右向左通过堆栈传递的(__fastcall 的前面部分由ecx,edx传)， 函数调用在返回前要由被调用者清理堆栈。


    __cdecl 是C Declaration的缩写（declaration，声明），表示C语言默认的函数调用方法：所有参数从右到左依次入栈，这些参数由调用者清除，称为手动清栈。
    被调用函数不会要求调用者传递多少参数，调用者传递过多或者过少的参数，甚至完全不同的参数都不会产生编译阶段的错误。


    __stdcall,__cdecl,_cdecl,_stdcall,__fastcall,_fastcall 区别简介  




    不解为什么要用WINAPI宏定义，查了后发现下面的定义：
    #define CALLBACK __stdcall
    #define WINAPI __stdcall
    #define WINAPIV __cdecl
    #define APIENTRY WINAPI
    #define APIPRIVATE __stdcall
    #define PASCAL __stdcall
    #define cdecl _cdecl
    #ifndef CDECL
    #define CDECL _cdecl
    #endif


    几乎我们写的每一个WINDOWS API函数都是__stdcall类型的，首先，需要了解两者之间的区别： WINDOWS的函数调用时需要用到栈（STACK，一种先入后出的存储结构）。当函数调用完成后，栈需要清楚，这里就是问题的关键，如何清除？？ 如果我们的函数使用了_cdecl，那么栈的清除工作是由调用者，用COM的术语来讲就是客户来完成的。这样带来了一个棘手的问题，不同的编译器产生栈的方式不尽相同，那么调用者能否正常的完成清除工作呢？答案是不能。 如果使用__stdcall，上面的问题就解决了，函数自己解决清除工作。所以，在跨（开发）平台的调用中，我们都使用__stdcall（虽然有时是以WINAPI的样子出现）。那么为什么还需要_cdecl呢？当我们遇到这样的函数如fprintf()它的参数是可变的，不定长的，被调用者事先无法知道参数的长度，事后的清除工作也无法正常的进行，因此，这种情况我们只能使用_cdecl。到这里我们有一个结论，如果你的程序中没有涉及可变参数，最好使用__stdcall关键字。






    __cdecl,__stdcall是声明的函数调用协议.主要是传参和弹栈方面的不同.一般c++用的是__cdecl,windows里大都用的是__stdcall(API) 


    __cdecl是C/C++和MFC程序默认使用的调用约定，也可以在函数声明时加上__cdecl关键字来手工指定。采用__cdecl约定时，函数参数按照从右到左的顺序入栈，并且由调用函数者把参数弹出栈以清理堆栈。因此，实现可变参数的函数只能使用该调用约定。由于每一个使用__cdecl约定的函数都要包含清理堆栈的代码，所以产生的可执行文件大小会比较大。__cdecl可以写成_cdecl。 
    __stdcall调用约定用于调用Win32 API函数。采用__stdcall约定时，函数参数按照从右到左的顺序入栈，被调用的函数在返回前清理传送参数的栈，函数参数个数固定。由于函数体本身知道传进来的参数个数，因此被调用的函数可以在返回前用一条ret n指令直接清理传递参数的堆栈。__stdcall可以写成_stdcall。 
    __fastcall约定用于对性能要求非常高的场合。__fastcall约定将函数的从左边开始的两个大小不大于4个字节（DWORD）的参数分别放在ECX和EDX寄存器，其余的参数仍旧自右向左压栈传送，被调用的函数在返回前清理传送参数的堆栈。__fastcall可以写成_fastcall






    __stdcall:


    _stdcall 调用约定相当于16位动态库中经常使用的PASCAL调用约定。


    
    在32位的VC++5.0中PASCAL调用约定不再被支持（实际上它已被定义为__stdcall。除了__pascal外，__fortran和__syscall也不被支持），取而代之的是__stdcall调用约定。两者实质上是一致的，即函数的参数自右向左通过栈传递，被调用的函数在返回前清理传送参数的内存栈，但不同的是函数名的修饰部分（关于函数名的修饰部分在后面将详细说明）。
    _stdcall是Pascal程序的缺省调用方式，通常用于Win32 Api中，函数采用从右到左的压栈方式，自己在退出时清空堆栈。VC将函数编译后会在函数名前面加上下划线前缀，在函数名后加上"@"和参数的字节数。


    _cdecl:


    _cdecl c调用约定, 按从右至左的顺序压参数入栈，由调用者把参数弹出栈。对于传送参数的内存栈是由调用者来维护的（正因为如此，实现可变参数的函数只能使用该调用约定）。另外，在函数名修饰约定方面也有所不同。


    _cdecl是C和C＋＋程序的缺省调用方式。每一个调用它的函数都包含清空堆栈的代码，所以产生的可执行文件大小会比调用_stdcall函数的大。函数采用从右到左的压栈方式。VC将函数编译后会在函数名前面加上下划线前缀。是MFC缺省调用约定。


    __fastcall:


    __fastcall调用约定是"人"如其名，它的主要特点就是快，因为它是通过寄存器来传送参数的（实际上，它用ECX和EDX传送前两个双字（DWORD）或更小的参数，剩下的参数仍旧自右向左压栈传送，被调用的函数在返回前清理传送参数的内存栈），在函数名修饰约定方面，它和前两者均不同。


    _fastcall方式的函数采用寄存器传递参数，VC将函数编译后会在函数名前面加上"@"前缀，在函数名后加上"@"和参数的字节数。


    thiscall:


    thiscall仅仅应用于"C++"成员函数。this指针存放于CX寄存器，参数从右到左压。thiscall不是关键词，因此不能被程序员指定。


    naked call:


    采用1-4的调用约定时，如果必要的话，进入函数时编译器会产生代码来保存ESI，EDI，EBX，EBP寄存器，退出函数时则产生代码恢复这些寄存器的内容。


    naked call不产生这样的代码。naked call不是类型修饰符，故必须和_declspec共同使用。


    另附:


    关键字 __stdcall、__cdecl和__fastcall可以直接加在要输出的函数前，也可以在编译环境的Setting...\C/C++ \Code Generation项选择。当加在输出函数前的关键字与编译环境中的选择不同时，直接加在输出函数前的关键字有效。它们对应的命令行参数分别为/Gz、/Gd和/Gr。缺省状态为/Gd，即__cdecl。


    要完全模仿PASCAL调用约定首先必须使用__stdcall调用约定，至于函数名修饰约定，可以通过其它方法模仿。还有一个值得一提的是WINAPI宏，Windows.h支持该宏，它可以将出函数翻译成适当的调用约定，在WIN32中，它被定义为__stdcall。使用WINAPI宏可以创建自己的APIs。


    名字修饰约定 


    1、修饰名(Decoration name) 
    “C”或者“C++”函数在内部（编译和链接）通过修饰名识别。修饰名是编译器在编译函数定义或者原型时生成的字符串。有些情况下使用函数的修饰名是必要的，如在模块定义文件里头指定输出“C++”重载函数、构造函数、析构函数，又如在汇编代码里调用“C””或“C++”函数等。 


    修饰名由函数名、类名、调用约定、返回类型、参数等共同决定。 


    2、名字修饰约定随调用约定和编译种类(C或C++)的不同而变化。函数名修饰约定随编译种类和调用约定的不同而不同，下面分别说明。 


    a、C编译时函数名修饰约定规则： 


    __stdcall调用约定在输出函数名前加上一个下划线前缀，后面加上一个“@”符号和其参数的字节数，格式为_functionname@number。 


    __cdecl调用约定仅在输出函数名前加上一个下划线前缀，格式为_functionname。


    __fastcall调用约定在输出函数名前加上一个“@”符号，后面也是一个“@”符号和其参数的字节数，格式为@functionname@number。 


    它们均不改变输出函数名中的字符大小写，这和PASCAL调用约定不同，PASCAL约定输出的函数名无任何修饰且全部大写。 


    b、C++编译时函数名修饰约定规则： 


    __stdcall调用约定： 
    1、以“?”标识函数名的开始，后跟函数名； 
    2、函数名后面以“@@YG”标识参数表的开始，后跟参数表； 
    3、参数表以代号表示： 
    X--void ， 
    D--char， 
    E--unsigned char， 
    F--short， 
    H--int， 
    I--unsigned int， 
    J--long， 
    K--unsigned long， 
    M--float， 
    N--double， 
    _N--bool， 
    .... 
    PA--表示指针，后面的代号表明指针类型，如果相同类型的指针连续出现，以“0”代替，一个“0”代表一次重复； 
    4、参数表的第一项为该函数的返回值类型，其后依次为参数的数据类型,指针标识在其所指数据类型前； 
    5、参数表后以“@Z”标识整个名字的结束，如果该函数无参数，则以“Z”标识结束。 


    其格式为“?functionname@@YG*****@Z”或“?functionname@@YG*XZ”，例如 
    int Test1（char *var1,unsigned long）-----“?Test1@@YGHPADK@Z” 
    void Test2（） -----“?Test2@@YGXXZ” 


    __cdecl调用约定： 
    规则同上面的_stdcall调用约定，只是参数表的开始标识由上面的“@@YG”变为“@@YA”。 


    __fastcall调用约定： 
    规则同上面的_stdcall调用约定，只是参数表的开始标识由上面的“@@YG”变为“@@YI”。 
    VC++对函数的省缺声明是“__cedcl“,将只能被C/C++调用. 


    CB在输出函数声明时使用4种修饰符号 
    //__cdecl 
    cb的默认值，它会在输出函数名前加_，并保留此函数名不变，参数按照从右到左的顺序依次传递给栈，也可以写成_cdecl和cdecl形式。 
    //__fastcall 
    她修饰的函数的参数将尽肯呢感地使用寄存器来处理，其函数名前加@，参数按照从左到右的顺序压栈； 
    //__pascal 
    它说明的函数名使用Pascal格式的命名约定。这时函数名全部大写。参数按照从左到右的顺序压栈； 
    //__stdcall 
    使用标准约定的函数名。函数名不会改变。使用__stdcall修饰时。参数按照由右到左的顺序压栈，也可以是_stdcall；


    VC++对函数的省缺声明是"__cedcl",将只能被C/C++调用.


    


    


    注意：


    1、_beginthread需要__cdecl的线程函数地址，_beginthreadex和CreateThread需要__stdcall的线程函数地址。


    2、一般WIN32的函数都是__stdcall。而且在Windef.h中有如下的定义：


    #define CALLBACK __stdcall


    #define WINAPI　 __stdcall


    3、extern "C" _declspec(dllexport) int __cdecl Add(int a, int b);


    typedef int (__cdecl*FunPointer)(int a, int b);


    修饰符的书写顺序如上。


    4、extern "C"的作用：如果Add(int a, int b)是在c语言编译器编译，而在c++文件使用，则需要在c++文件中声明：extern "C" Add(int a, int b)，因为c编译器和c++编译器对函数名的解释不一样（c++编译器解释函数名的时候要考虑函数参数，这样是了方便函数重载，而在c语言中不存在函数重载的问题），使用extern "C"，实质就是告诉c++编译器，该函数是c库里面的函数。如果不使用extern "C"则会出现链接错误。


    一般象如下使用：


    #ifdef _cplusplus


    #define EXTERN_C extern "C"


    #else


    #define EXTERN_C extern


    #endif


    #ifdef _cplusplus


    extern "C"{


    #endif


    EXTERN_C int func(int a, int b);


    #ifdef _cplusplus


    }


    #endif


    5、MFC提供了一些宏，可以使用AFX_EXT_CLASS来代替__declspec(DLLexport)，并修饰类名，从而导出类，AFX_API_EXPORT来修饰函数，AFX_DATA_EXPORT来修饰变量


    AFX_CLASS_IMPORT：__declspec(DLLexport)


    AFX_API_IMPORT：__declspec(DLLexport)


    AFX_DATA_IMPORT：__declspec(DLLexport)


    AFX_CLASS_EXPORT：__declspec(DLLexport)


    AFX_API_EXPORT：__declspec(DLLexport)


    AFX_DATA_EXPORT：__declspec(DLLexport)


    AFX_EXT_CLASS：#ifdef _AFXEXT


    AFX_CLASS_EXPORT


            #else


    AFX_CLASS_IMPORT


    6、DLLMain负责初始化(Initialization)和结束(Termination)工作，每当一个新的进程或者该进程的新的线程访问DLL时，或者访问DLL的每一个进程或者线程不再使用DLL或者结束时，都会调用DLLMain。但是，使用TerminateProcess或TerminateThread结束进程或者线程，不会调用DLLMain。


    7、一个DLL在内存中只有一个实例


    DLL程序和调用其输出函数的程序的关系：


    1)、DLL与进程、线程之间的关系


    DLL模块被映射到调用它的进程的虚拟地址空间。


    DLL使用的内存从调用进程的虚拟地址空间分配，只能被该进程的线程所访问。


    DLL的句柄可以被调用进程使用；调用进程的句柄可以被DLL使用。


    DLLDLL可以有自己的数据段，但没有自己的堆栈，使用调用进程的栈，与调用它的应用程序相同的堆栈模式。


    2)、关于共享数据段


    DLL定义的全局变量可以被调用进程访问；DLL可以访问调用进程的全局数据。使用同一DLL的每一个进程都有自己的DLL全局变量实例。如果多个线程并发访问同一变量，则需要使用同步机制；对一个DLL的变量，如果希望每个使用DLL的线程都有自己的值，则应该使用线程局部存储(TLS，Thread Local Strorage)。




3. 关于【通用】函式，__UNICODE 识别字


    如果定义了名为_UNICODE 的识别字，并且程式中包含了TCHAR.H表头档案，
    那么_tcslen 就定义为wcslen：
    #define _tcslen wcslen
    如果没有定义UNICODE，则_tcslen 定义为strlen：
    #define _tcslen strlen


    如果定义了 _UNICODE 识别字，那么TCHAR 就是wchar_t：
    typedef wchar_t TCHAR ;
    否则，TCHAR 就是char：
    typedef char TCHAR ;


    #define __T(x) L##x             
    #define __T(x) x


    等等


    另外：
    #define _T（x） __T（x）
    #define _TEXT（x） __T（x）






4.  粘黏符号
    #define __T(x) L##x
    如果x是“hello” 那么 __T(x) 就是L“hello”


5.  关于win32的一些关键字


    typedef char CHAR ;
    typedef wchar_t WCHAR ;


    typedef CHAR * PCHAR, * LPCH, * PCH, * NPSTR, * LPSTR, * PSTR ;
    typedef CONST CHAR * LPCCH, * PCCH, * LPCSTR, * PCSTR ;


    typedef WCHAR * PWCHAR, * LPWCH, * PWCH, * NWPSTR, * LPWSTR, * PWSTR ;
    typedef CONST WCHAR * LPCWCH, * PCWCH, * LPCWSTR, * PCWSTR ;




    #ifdef UNICODE
    typedef WCHAR TCHAR, * PTCHAR ;
    typedef LPWSTR LPTCH, PTCH, PTSTR, LPTSTR ;
    typedef LPCWSTR LPCTSTR ;
    #else
    typedef char TCHAR, * PTCHAR ;
    typedef LPSTR LPTCH, PTCH, PTSTR, LPTSTR ;
    typedef LPCSTR LPCTSTR ;
    #endif


6. 呼叫函式
    #ifdef UNICODE
    #define MessageBox MessageBoxW
    #else
    #define MessageBox MessageBoxA
    #endif