Uso della macro DECLARE_API

Ogni comando di estensione in una DLL dell'estensione WdbgExts viene dichiarato usando la macro DECLARE_API. Questa macro è definita in wdbgexts.h.

Il formato di base del codice per un comando di estensione è:

DECLARE_API( myextension )
{
    code for myextension
}

La macro DECLARE_API configura un'interfaccia standard per i comandi di estensione. Ad esempio, se l'utente ha passato qualsiasi argomento al comando di estensione, l'intera stringa di argomento verrà archiviata come stringa e un puntatore a questa stringa (PCSTR) verrà passato alla funzione di estensione come args.

Se si usano puntatori a 64 bit, la macro DECLARE_API viene definita come segue:

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

Se si usano puntatori a 32 bit, DECLARE_API rimane lo stesso, ad eccezione del fatto che dwCurrentPc sarà del tipo ULONG anziché ULONG64. Tuttavia, i puntatori a 64 bit sono consigliati per qualsiasi estensione scritta. Per informazioni dettagliate, vedere Puntatori a 32 bit e puntatori a 64 bit .