IDebugControl2::Assemble-Methode (dbgeng.h)

Artikel
02/23/2024

Die Assemble-Methode stellt 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
);

Parameter

[in] Offset

Gibt den Speicherort im Speicher des Ziels an, an dem die zusammengesetzte Anweisung platziert werden soll.

[in] Instr

Gibt die Anweisung zum Zusammenbauen an. Die Anweisung wird gemäß dem effektiven Prozessortyp des Ziels (von SetEffectiveProcessorType zurückgegeben) zusammengesetzt.

[out] EndOffset

Empfängt den Speicherort im Speicher des Ziels unmittelbar nach der zusammengestellten Anweisung. EndOffset kann verwendet werden, wenn mehrere Anweisungen zusammengebaut 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 .

Hinweise

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

Hinweis Die Methoden Assemble und AssembleWide werden auf einigen Architekturen nicht unterstützt, und auf 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 Debugger-Engine-API finden Sie unter Anweisungen zum Zusammenbauen und Disassemblieren.