Return to readme.txt CVS log

Up to [WindowsNT SDKs] / mstools / samples / wdbgexts

Annotation of mstools/samples/wdbgexts/readme.txt, revision 1.1

1.1     ! root        1: Sample: Creating a WinDbg Extension
        !             2: 
        !             3: 
        !             4: Summary:
        !             5: 
        !             6: The purpose of the WDBGEXTS sample is to demonstrate how to create a WinDbg
        !             7: extension. This is a port of a sample demonstrating how to create an NTSD
        !             8: extension.
        !             9: 
        !            10: Extensions are DLL entry points. The arguments passed to an extension are:
        !            11: 
        !            12:     HANDLE hCurrentProcess - Supplies a handle to the current process (at
        !            13:         the time the extension is called).
        !            14: 
        !            15:     HANDLE hCurrentThread - Supplies a handle to the current thread (at
        !            16:         the time the extension is called).
        !            17: 
        !            18:     DWORD CurrentPc - Supplies the current pc at the time the extension is
        !            19:         called.
        !            20: 
        !            21:     PWINDBG_EXTENSION_APIS lpExtensionApis - Supplies the address of the
        !            22:         functions callable by this extension.
        !            23: 
        !            24:     LPSTR lpArgumentString - Supplies the command-line arguments for the
        !            25:         extension.
        !            26: 
        !            27: The type PWINDBG_EXTENSION_APIS is defined in \mstools\h\wdbgexts.h.
        !            28: 
        !            29: Note that in the makefile the -Gz option is specified to compiler in order
        !            30: to ensure that __stdcall is used.
        !            31: 
        !            32: More Information:
        !            33: 
        !            34: The following is a description of the exported functions
        !            35: 
        !            36:     igrep()
        !            37: 
        !            38:         Searches the instruction stream for a pattern.
        !            39: 
        !            40:     str()
        !            41: 
        !            42:        Given a pointer to a string, it prints out the string, its length,
        !            43:        and its location in memory.
        !            44: 
        !            45: In order to use the commands contained in WDBGEXTS.DLL, make sure that the
        !            46: DLL is placed in a directory which is on the PATH.
        !            47: 
        !            48: The syntax for the commands is as follows
        !            49: 
        !            50: 
        !            51:     !wdbgexts.igrep [pattern [expression] ]
        !            52: 
        !            53:     !wdbgexts.str [string]

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.