使用 DECLARE_API 巨集

WdbgExts 擴充功能 DLL 中的每個擴充功能命令都會使用 DECLARE_API 巨集宣告。 此巨集定義於 wdbgexts.h 中。

延伸模組命令程式代碼的基本格式為：

DECLARE_API( myextension )
{
    code for myextension
}

DECLARE_API巨集用於設定擴展命令的標準接口。 例如，如果使用者將任何自變數傳遞至擴充命令，則整個自變數字串會儲存為字串，而此字串的指標會以 args的形式傳遞至延伸模組函式。

如果您使用 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 位指標。