wdbgexts.h-Header

Dieser Header wird vom Debugger verwendet. Weitere Informationen finden Sie unter

• Debugger

wdbgexts.h enthält die folgenden Programmierschnittstellen:

Functions

GetCurrentProcessAddr Die GetCurrentProcessAddr-Funktion gibt den Speicherort der Systemdaten zurück, der den aktuellen Prozess beschreibt.
GetCurrentProcessHandle Die GetCurrentProcessHandle-Funktion gibt das Systemhandle für den aktuellen Prozess zurück.
GetCurrentThreadAddr Die GetCurrentThreadAddr-Funktion gibt den Speicherort der Systemdaten zurück, die den aktuellen Thread beschreiben.
GetDebuggerCacheSize Die GetDebuggerCacheSize-Funktion gibt die Größe des Caches zurück, der vom Debugger zum Speichern von Daten verwendet wird, die vom Ziel abgerufen wurden.
GetDebuggerData Die GetDebuggerData-Funktion ruft Informationen ab, die in einem Datenblock gespeichert sind.
GetExpressionEx Die GetExpressionEx-Funktion wertet einen Ausdruck aus. Der Ausdruck wird mithilfe des MASM-Auswerters ausgewertet und kann Aliase enthalten.
GetFieldData Die GetFieldData-Funktion gibt den Wert eines Elements in einer Struktur zurück.
GetFieldOffset Die GetFieldOffset-Funktion gibt den Offset eines Elements vom Anfang einer Struktur zurück.
Getfieldvalue Das Makro GetFieldValue ist ein dünner Wrapper um die GetFieldData-Funktion. Es wird als Benutzerfreundlichkeit zum Lesen des Werts eines Elements in einer Struktur bereitgestellt.
GetInputLine Die GetInputLine-Funktion fordert eine Eingabezeichenfolge vom Debugger an.
GetKdContext Die GetKdContext-Funktion gibt die Gesamtzahl der Prozessoren und die Anzahl des aktuellen Prozessors in der Struktur zurück, auf die ppi verweist.
GetPebAddress Die GetPebAddress-Funktion gibt die Adresse des Prozessumgebungsblocks (PEB) für einen Systemprozess zurück.
GetSetSympath Die GetSetSympath-Funktion kann zum Abrufen oder Festlegen des Symbolsuchpfad verwendet werden.
GetShortField Die GetShortField-Funktion liest den Wert eines Members in einer Struktur, wenn seine Größe kleiner oder gleich 8 Bytes ist, oder initialisiert eine Struktur, damit sie später gelesen werden kann.
GetTebAddress Die GetTebAddress-Funktion gibt die Adresse des Threadumgebungsblocks (TEB) für den aktuellen Betriebssystemthread zurück.
GetTypeSize Die GetTypeSize-Funktion gibt die Größe eines instance des angegebenen Typs im Speicher des Ziels zurück.
IsPtr64 Die IsPtr64-Funktion bestimmt, ob das Ziel 64-Bit-Zeiger verwendet.
ListType Die ListType-Funktion ruft eine angegebene Rückruffunktion für jedes Element in einer verknüpften Liste auf.
ReadControlSpace Die ReadControlSpace-Funktion liest den prozessorspezifischen Steuerraum in das Array ein, auf das buf verweist.
ReadControlSpace64 Die ReadControlSpace64-Funktion liest den prozessorspezifischen Steuerraum in das Array ein, auf das buf verweist.
ReadIoSpace Die ReadIoSpace-Funktion liest aus den E/A-Speicherorten des Systems.
ReadIoSpace64 Die ReadIoSpace64-Funktion liest aus den E/A-Speicherorten des Systems.
ReadIoSpaceEx Die ReadIoSpaceEx-Funktion ist eine erweiterte Version von ReadIoSpace.
ReadIoSpaceEx64 Die ReadIoSpaceEx64-Funktion ist eine erweiterte Version von ReadIoSpace64.
ReadListEntry Die ReadListEntry-Funktion liest einen doppelt verknüpften Listeneintrag aus dem Speicher des Ziels.
ReadMsr Die ReadMsr-Funktion liest den Inhalt eines Model-Specific Registers (MSR).
ReadPhysical Die ReadPhysical-Funktion liest aus dem physischen Arbeitsspeicher.
ReadPhysicalWithFlags Die ReadPhysicalWithFlags-Funktion liest aus dem physischen Arbeitsspeicher.
ReadPointer Die ReadPointer-Funktion liest einen Zeiger aus dem Ziel.
ReadPtr Die ReadPtr-Funktion liest einen Zeiger aus dem Ziel. ReadPointer sollte anstelle dieser Funktion verwendet werden, da der Rückgabewert von ReadPointer mit dem Rest der WdbgExts-API konsistenter ist.
ReloadSymbols Die ReloadSymbols-Funktion löscht Symbolinformationen aus dem Debugger, sodass sie bei Bedarf neu geladen werden können. Diese Funktion verhält sich genauso wie der Debuggerbefehl .reload.
SearchMemory Die SearchMemory-Funktion durchsucht den virtuellen Arbeitsspeicher des Ziels nach einem angegebenen Bytemuster.
SetThreadForOperation Die SetThreadForOperation-Funktion legt den Thread fest, der für den nächsten StackTrace-Aufruf verwendet werden soll.
SetThreadForOperation64 Die SetThreadForOperation64-Funktion legt den Thread fest, der für den nächsten StackTrace-Aufruf verwendet werden soll.
TranslateVirtualToPhysical Die TranslateVirtualToPhysical-Funktion übersetzt eine virtuelle Speicheradresse in eine physische Speicheradresse.
WriteControlSpace Die WriteControlSpace-Funktion schreibt in den prozessorspezifischen Steuerraum des aktuellen Ziels.
WriteIoSpace Die WriteIoSpace-Funktion schreibt in die E/A-Speicherorte des Systems.
WriteIoSpace64 Die WriteIoSpace64-Funktion schreibt in die E/A-Speicherorte des Systems.
WriteIoSpaceEx Die WriteIoSpaceEx-Funktion ist eine erweiterte Version von WriteIoSpace.
WriteIoSpaceEx64 Die WriteIoSpaceEx64-Funktion ist eine erweiterte Version von WriteIoSpace64.
WriteMsr Die WriteMsr-Funktion schreibt in eine Model-Specific Register (MSR).
WritePhysical Die WritePhysical-Funktion schreibt in den physischen Arbeitsspeicher.
WritePhysicalWithFlags Die WritePhysicalWithFlags-Funktion schreibt in den physischen Arbeitsspeicher.
WritePointer Die WritePointer-Funktion schreibt einen Zeiger auf das Ziel.

Rückruffunktionen

PSYM_DUMP_FIELD_CALLBACK Die PSYM_DUMP_FIELD_CALLBACK Rückruffunktion wird vom Debuggermodul während des IG_DUMP_SYMBOL_INFO Ioctl-Vorgangs mit Informationen zu einem Element im angegebenen Symbol aufgerufen.
PWINDBG_CHECK_CONTROL_C Die funktion PWINDBG_CHECK_CONTROL_C (CheckControlC) überprüft, ob der Benutzer STRG+C gedrückt hat. Verwenden Sie PWINDBG_CHECK_CONTROL_C in allen Schleifen, damit der Benutzer STRG+C drücken kann, um lange Prozesse zu beenden.
PWINDBG_CHECK_VERSION Die Rückruffunktion PWINDBG_CHECK_VERSION (CheckVersion) überprüft, ob die Version des Erweiterungsmoduls mit der Debuggerversion übereinstimmt, und gibt eine Warnmeldung aus, wenn ein Konflikt vorliegt.
PWINDBG_DISASM Die funktion PWINDBG_DISASM (Disasm) zerlegt die anweisung, auf die von lpOffset verwiesen wird, und platziert die druckbare Zeichenfolge in lpBuffer.
PWINDBG_EXTENSION_API_VERSION Die Rückruffunktion PWINDBG_EXTENSION_API_VERSION (ExtensionApiVersion) gibt Versionsinformationen zur Erweiterungs-DLL zurück.
PWINDBG_EXTENSION_DLL_INIT Die Rückruffunktion PWINDBG_EXTENSION_DLL_INIT ( WinDbgExtensionDllInit) wird verwendet, um das Erweiterungsmodul zu laden und zu initialisieren.
PWINDBG_GET_EXPRESSION Die funktion PWINDBG_GET_EXPRESSION (GetExpression) gibt den Wert des Ausdrucks zurück. Der Ausdruck wird mit dem aktuellen Ausdrucksauswerter ausgewertet und kann Aliase enthalten.
PWINDBG_GET_SYMBOL Die funktion PWINDBG_GET_SYMBOL (GetSymbol) sucht das Symbol, das der Adresse am nächsten liegt.
PWINDBG_GET_THREAD_CONTEXT_ROUTINE Die funktion PWINDBG_GET_THREAD_CONTEXT_ROUTINE (GetContext) implementiert die Funktionalität, die der GetThreadContext-Routine von Microsoft Win32 ähnelt. Es gibt den Kontext des zu debuggenden Prozesses zurück.
PWINDBG_IOCTL_ROUTINE Die funktion PWINDBG_IOCTL_ROUTINE (Ioctl) führt eine Vielzahl verschiedener Vorgänge aus. Ein Großteil der Funktionalität spiegelt die Funktionalität anderer Funktionen in wdbgexts.h.
PWINDBG_OUTPUT_ROUTINE Die Rückruffunktion implementiert die Funktion zum Drucken einer formatierten Zeichenfolge im Debuggerbefehlsfenster.
PWINDBG_READ_PROCESS_MEMORY_ROUTINE Die PWINDBG_READ_PROCESS_MEMORY_ROUTINE-Funktion (ReadMemory) funktioniert wie die Win32 ReadProcessMemory-Funktion. Es liest Arbeitsspeicher aus dem zu debuggenden Prozess. Der gesamte zu lesende Bereich muss zugänglich sein, andernfalls schlägt der Vorgang fehl.
PWINDBG_SET_THREAD_CONTEXT_ROUTINE Die funktion PWINDBG_SET_THREAD_CONTEXT_ROUTINE (SetContext) ähnelt der Win32 SetThreadContext-Routine. Es legt den Kontext des zu debuggenden Prozesses fest.
PWINDBG_STACKTRACE_ROUTINE Die funktion PWINDBG_STACKTRACE_ROUTINE (StackTrace) ruft eine Stapelablaufverfolgung für den zu debuggenden Prozess ab. Gibt die Anzahl von Frames zurück, die in den Puffer gelesen werden, auf die von StackFrames verwiesen wird.
PWINDBG_WRITE_PROCESS_MEMORY_ROUTINE Die PWINDBG_WRITE_PROCESS_MEMORY_ROUTINE-Funktion (WriteMemory) funktioniert wie die Win32 WriteProcessMemory-Routine. Es schreibt Arbeitsspeicher in den zu debuggenden Prozess. Der gesamte zu schreibende Bereich muss zugänglich sein, andernfalls schlägt der Vorgang fehl.

Strukturen

BUSDATA Der IG_GET_BUS_DATA Ioctl-Vorgang liest Daten aus einem Systembus, und der IG_SET_BUS_DATA Ioctl-Vorgang schreibt Daten in einen Systembus.
DBGKD_GET_VERSION64 Der IG_GET_KERNEL_VERSION Ioctl-Vorgang empfängt Informationen im Zusammenhang mit der Betriebssystemversion des Ziels.
DEBUG_TYPED_DATA Die DEBUG_TYPED_DATA-Struktur beschreibt typisierte Daten im Speicher des Ziels.
EXT_TYPED_DATA Die EXT_TYPED_DATA-Struktur wird an den DEBUG_REQUEST_EXT_TYPED_DATA_ANSI Request-Vorgang übergeben und zurückgegeben. Sie enthält die Eingabe- und Ausgabeparameter für den Vorgang sowie die Angabe, welche bestimmte Unteroperation ausgeführt werden soll.
FIELD_INFO Die FIELD_INFO-Struktur wird vom IG_DUMP_SYMBOL_INFOIoctl-Vorgang verwendet, um Informationen zu einem Element in einer Struktur bereitzustellen.
POINTER_SEARCH_PHYSICAL Der IG_POINTER_SEARCH_PHYSICAL Ioctl-Vorgang durchsucht den physischen Speicher des Ziels nach Zeigern, die innerhalb eines angegebenen Bereichs liegen.
READCONTROLSPACE Erfahren Sie, wie die ReadControlSpace-Funktion den prozessorspezifischen Steuerraum in das Array einliest, auf das buf verweist.
READCONTROLSPACE64 Erfahren Sie, wie die ReadControlSpace64-Funktion den prozessorspezifischen Steuerraum in das Array einliest, auf das buf verweist.
SEARCHMEMORY Erfahren Sie, wie die SearchMemory-Funktion den virtuellen Arbeitsspeicher des Ziels nach einem angegebenen Bytemuster durchsucht.
SYM_DUMP_PARAM Die IG_DUMP_SYMBOL_INFO Ioctl-Vorgangs enthält Informationen zum Typ eines Symbols.
WDBGEXTS_THREAD_OS_INFO Der IG_GET_THREAD_OS_INFO Ioctl-Vorgang gibt Informationen zu einem Betriebssystemthread im Ziel zurück. Beim Aufrufen von Ioctl, bei dem IoctlType auf IG_GET_THREAD_OS_INFO festgelegt ist, sollte IpvData eine instance der WDBGEXTS_THREAD_OS_INFO-Struktur enthalten.

Enumerationen

EXT_TDOP Die EXT_TDOP-Enumeration wird im Vorgangselement der EXT_TYPED_DATA-Struktur verwendet, um anzugeben, welche Unteroperation vom DEBUG_REQUEST_EXT_TYPED_DATA_ANSI Request-Vorgang ausgeführt wird.