原始碼模板

#ifndef XXX_H
#define XXX_H

#ifdef _WIN32
    #if defined(XXX_STATIC)
        #define DLL_API
    #else
        #if defined(DLL_EXPORTS)
            #define DLL_API __declspec(dllexport)
        #else
            #define DLL_API __declspec(dllimport)
        #endif // DLL_EXPORTS 
    #endif
 
 // XXX_STATIC
    #define CALLSPEC __stdcall
#else
    #if __GNUC__ >= 4
        #define DLL_API __attribute__((visibility("default")))
    #else
        #define DLL_API
    #endif
    #define CALLSPEC
#endif // _WIN32

//--------------------data-struct------------------------------
#ifdef __cplusplus
 


#define ENUM(x) \
enum x

#define STRUCT(x) \
struct x

#else

#define ENUM(x) \
typedef enum x x; \
enum x

#define STRUCT(x) \
typedef struct x x; \
struct x

#endif

#ifdef __GNUC__
#define GNUC_ALIGN(n) __attribute__((align(n)))
#endif

ENUM(x) {

};

#ifdef _WIN32
#pragma pack(push)
#pragma pack(n)
 

#endif

STRUCT(x) {

} GNUC_ALIGN(n);

#ifdef _WIN32
#pragma pack(pop)
#endif

//===============================================================

//---------------------function----------------------------------
#ifdef __cplusplus
extern "C" {
#endif

DLL_API void CALLSPEC foobar();

#ifdef __cplusplus
}
#endif
//===============================================================

#endif // XXX_H

說明

防止標頭檔案重複包含

msvc下可以使用#pragma once這樣的方式，但為了跨編譯器，最好習慣如下通用形式

#ifndef XXX_H
#define XXX_H
#endif

Windows下匯出dll說明

#if defined(DLL_EXPORTS)
    #define DLL_API __declspec(dllexport)
#else
    #define DLL_API __declspec(dllimport)
#endif // DLL_EXPORTS

Windows下如果需要使用靜態庫，需要新增#define XXX_STATIC

呼叫約定

#define CALLSPEC __stdcall

Windows API介面一般使用__stdcall呼叫約定(default is __cdecl)
__stdcall和__cdecl引數都是從右到左入棧，不同的是__stdcall由函式自身管理棧，__cdecl由呼叫者管理棧。
此為msvc x86下__stdcall生成的dll符號名會形如[email protected]，需要加.def檔案強制命名。

def檔案格式如下

LIBRARY "xxx"

EXPORTS

SdkInit         @1
SdkCleanup      @2

msvc可以使用dumpbin命令檢視dll的匯出符號，使用lib命令生成xxx.lib動態連結庫匯入檔案

dumpbin /exports xxx.dll
lib   /def:xxx.def  /mechine:ARM|ARM64|EBC|X64|X86 /out:xxx.lib

更詳細的命令說明請直接在cmd下檢視命令幫助

typedef struct

#define ENUM(x)
#define STRUCT(x)

巨集定義ENUM和STRUCT的目的是給x加上typedef定義型別，使得C能夠和C++一樣能夠直接使用x，而不是struct x這樣繁瑣的方式。

位元組對齊

msvc和gnuc位元組對齊的語法不同，msvc使用#pragma pack(n)，gnuc使用__attribute__((align(n)))

#ifdef __GNUC__
#define GNUC_ALIGN(n) __attribute__((align(n)))
#endif

#ifdef _WIN32
#pragma pack(push)
#pragma pack(n)
#endif

STRUCT(x){

} GNUC_ALIGN(n);

#ifdef _WIN32
#pragma pack(pop)
#endif