Utilisation de la macro DECLARE_API

Chaque commande d’extension dans une DLL d’extension WdbgExts est déclarée à l’aide de la macro DECLARE_API. Cette macro est définie dans wdbgexts.h.

Le format de base du code d’une commande d’extension est le suivant :

DECLARE_API( myextension )
{
    code for myextension
}

La macro DECLARE_API configure une interface standard pour les commandes d’extension. Par exemple, si l’utilisateur a passé des arguments à la commande d’extension, la chaîne d’argument entière est stockée sous forme de chaîne et un pointeur vers cette chaîne (PCSTR) est passé à la fonction d’extension en tant qu’arguments.

Si vous utilisez des pointeurs 64 bits, la macro DECLARE_API est définie comme suit :

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

Si vous utilisez des pointeurs 32 bits, DECLARE_API reste le même, sauf que dwCurrentPc sera de type ULONG au lieu d’ULONG64. Toutefois, des pointeurs 64 bits sont recommandés pour toute extension que vous écrivez. Pour plus d’informations, consultez Pointeurs 32 bits et Pointeurs 64 bits .