IDebugControl2::OutputDisassembly-Methode (dbgeng.h)
Die OutputDisassembly-Methode disassembliert eine Prozessoranweisung und sendet die Disassemblierung an die Ausgaberückrufe.
Syntax
HRESULT OutputDisassembly(
[in] ULONG OutputControl,
[in] ULONG64 Offset,
[in] ULONG Flags,
[out] PULONG64 EndOffset
);
Parameter
[in] OutputControl
Gibt das Ausgabesteuerelement an, das bestimmt, welche Ausgaberückrufe des Clients die Ausgabe empfangen. Mögliche Werte finden Sie unter DEBUG_OUTCTL_XXX. Weitere Informationen zur Ausgabe finden Sie unter Eingabe und Ausgabe.
[in] Offset
Gibt den Speicherort der Anweisung zum Disassemblieren im Speicher des Ziels an.
[in] Flags
Gibt die Bitflags an, die das Verhalten dieser Methode beeinflussen. In der folgenden Tabelle sind die Bits aufgeführt, die festgelegt werden können.
Bit-Flag | Effekt beim Festlegen |
---|---|
DEBUG_DISASM_EFFECTIVE_ADDRESS | Berechnen Sie die effektive Adresse aus den aktuellen Registerinformationen, und zeigen Sie sie an. |
DEBUG_DISASM_MATCHING_SYMBOLS | Wenn die Adresse der Anweisung eine exakte Symbol-Übereinstimmung aufweist, geben Sie das Symbol aus. |
DEBUG_DISASM_SOURCE_LINE_NUMBER | Fügen Sie die Quellzeilennummer der Anweisung in die Ausgabe ein. |
DEBUG_DISASM_SOURCE_FILE_NAME | Fügen Sie den Namen der Quelldatei in die Ausgabe ein. |
[out] EndOffset
Empfängt den Speicherort im Speicher des Ziels der Anweisung, die der disassemblierten Anweisung folgt.
Rückgabewert
Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .
Rückgabecode | BESCHREIBUNG |
---|---|
|
Die Methode war erfolgreich. |
Hinweise
Die Assemblysprache hängt vom effektiven Prozessortyp des Zielsystems ab. Informationen zur Assemblysprache finden Sie in der Prozessordokumentation.
Eine Übersicht über die Verwendung der Assembly in Debuggeranwendungen finden Sie unter Debuggen im Assemblymodus. Weitere Informationen zur Verwendung der Assembly mit der Debugger-Engine-API finden Sie unter Anweisungen zum Zusammenbauen und Disassemblieren.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Desktop |
Kopfzeile | dbgeng.h (einschließlich Dbgeng.h) |