Compartir a través de


Uso de la macro DECLARE_API

Cada comando de extensión de un archivo DLL de extensión WdbgExts se declara mediante la macro DECLARE_API. Esta macro se define en wdbgexts.h.

El formato básico del código para un comando de extensión es:

DECLARE_API( myextension )
{
    code for myextension
}

La macro DECLARE_API configura una interfaz estándar para comandos de extensión. Por ejemplo, si el usuario pasó argumentos al comando de extensión, toda la cadena de argumento se almacenará como una cadena y se pasará un puntero a esta cadena (PCSTR) a la función de extensión como argumentos.

Si usa punteros de 64 bits, la macro DECLARE_API se define de la siguiente manera:

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

Si usa punteros de 32 bits, DECLARE_API seguirá siendo el mismo, excepto que dwCurrentPc será del tipo ULONG en lugar de ULONG64. Sin embargo, se recomiendan punteros de 64 bits para cualquier extensión que escriba. Consulte Punteros de 32 bits y punteros de 64 bits para obtener más información.