Freigeben über


IDebugControl::Assemble-Methode (dbgeng.h)

Die Assemble-Methode fasst eine einzelne Prozessoranweisung zusammen. Die zusammengesetzte Anweisung wird im Speicher des Ziels platziert.

Syntax

HRESULT Assemble(
  [in]  ULONG64  Offset,
  [in]  PCSTR    Instr,
  [out] PULONG64 EndOffset
);

Die Parameter

[in] Offset

Gibt die Position im Speicher des Ziels an, um die zusammengesetzte Anweisung zu platzieren.

[in] Instr

Gibt die Anweisung an, die zusammengestellt werden soll. Die Anweisung wird entsprechend dem effektiven Prozessortyp des Ziels (zurückgegeben von SetEffectiveProcessorType) zusammengefasst.

[out] EndOffset

Empfängt die Position im Speicher des Ziels unmittelbar nach der zusammengestellten Anweisung. EndOffset kann beim Zusammenstellen mehrerer Anweisungen verwendet werden.

Rückgabewert

Rückgabecode BESCHREIBUNG
S_OK
Die Methode war erfolgreich.
 

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Bemerkungen

Die Assemblysprache hängt vom effektiven Prozessortyp des Zielcomputers ab. Informationen zur Assemblysprache finden Sie in der Prozessordokumentation.

Anmerkung Die Methoden "Assemble" und "AssembleWide " werden für einige Architekturen nicht unterstützt, und bei einigen anderen Architekturen werden nicht alle Anweisungen unterstützt.
 
Die von GetAssemblyOptions zurückgegebenen Assemblysprachenoptionen wirken sich auf den Vorgang dieser Methode aus.

Eine Übersicht über die Verwendung der Assembly in Debuggeranwendungen finden Sie unter Debuggen im Assemblymodus. Weitere Informationen zur Verwendung der Assembly mit der Debuggermodul-APIfinden Sie unter Assembly- und Disassemblierungsanweisungen.

Anforderungen

Anforderung Wert
Zielplattform Arbeitsfläche
Kopfzeile dbgeng.h (include Dbgeng.h)

Siehe auch

zerlegen

GetAssemblyOptions-

IDebugControl-

IDebugControl2-

IDebugControl3-