使用 DECLARE_API 宏

WdbgExts 延伸模組 DLL 中的每個擴充命令都會使用 DECLARE_API 宏來宣告。 此巨集定義于 wdbgexts.h 中。

擴充功能命令之程式碼的基本格式為：

DECLARE_API( myextension )
{
    code for myextension
}

DECLARE_API宏會設定擴充功能命令的標準介面。 例如，如果使用者將任何引數傳遞至擴充命令，則整個引數字串會儲存為字串，而此字串的指標 (PCSTR) 將會以 引數的形式傳遞至延伸模組函式。

如果您使用 64 位指標，DECLARE_API宏的定義如下：

#define DECLARE_API(s)                             \
    CPPMOD VOID                                    \
    s(                                             \
        HANDLE                 hCurrentProcess,    \
        HANDLE                 hCurrentThread,     \
        ULONG64                dwCurrentPc,        \
        ULONG                  dwProcessor,        \
        PCSTR                  args                \
     )

如果您使用 32 位指標，DECLARE_API保持不變，但 dwCurrentPc 的類型為 ULONG，而不是 ULONG64。 不過，建議針對您要寫入的任何延伸模組使用 64 位指標。 如需詳細資訊，請參閱 32 位指標和 64 位指標 。