Używanie makra DECLARE_API

Każde polecenie rozszerzenia w dll rozszerzenia WdbgExts jest deklarowane przy użyciu makra DECLARE_API. To makro jest definiowane w pliku wdbgexts.h.

Podstawowy format kodu dla polecenia rozszerzenia to:

DECLARE_API( myextension )
{
    code for myextension
}

Makro DECLARE_API konfiguruje standardowy interfejs dla poleceń rozszerzeń. Jeśli na przykład użytkownik przekazał jakiekolwiek argumenty do polecenia rozszerzenia, cały ciąg argumentu będzie przechowywany jako ciąg, a wskaźnik do tego ciągu (PCSTR) zostanie przekazany do funkcji rozszerzenia jako args.

Jeśli używasz 64-bitowych wskaźników, makro DECLARE_API jest definiowane w następujący sposób:

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

Jeśli używasz 32-bitowych wskaźników, DECLARE_API pozostaje taka sama, z tą różnicą, że dwCurrentPc będzie typu ULONG zamiast ULONG64. Jednak 64-bitowe wskaźniki są zalecane dla dowolnego rozszerzenia, które piszesz. Aby uzyskać szczegółowe informacje, zobacz 32-bitowe wskaźniki i wskaźniki 64-bitowe .