IDebugControl::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 zu assemblierende Anweisung an. Die Anweisung wird gemäß dem effektiven Prozessortyp des Ziels (von SetEffectiveProcessorType zurückgegeben) zusammengestellt.

[out] EndOffset

Empfängt den Speicherort im Speicher des Ziels unmittelbar nach der zusammengesetzten 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 .

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 in einigen Architekturen nicht unterstützt, und in 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 von 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.