IDebugControl3::SetAssemblyOptions 方法 (dbgeng.h)
SetAssemblyOptions 方法设置程序集和反汇编选项,这些选项会影响 调试器引擎 程序集和反汇编目标处理器指令的方式。
语法
HRESULT SetAssemblyOptions(
[in] ULONG Options
);
参数
[in] Options
指定要由 调试器引擎使用的新程序集和反汇编选项。 选项 是位集;它将替换现有程序集和反汇编选项。 有关可能的值,请参阅“备注”。 DEBUG_ASMOPT_DEFAULT可用于设置默认选项。
返回值
此方法还可以返回错误值。 有关详细信息,请参阅 返回值。
返回代码 | 描述 |
---|---|
|
该方法成功。 |
言论
有关将程序集与调试器引擎 API 配合使用的详细信息,请参阅 程序集和反汇编指令。
程序集和反汇编选项会影响调试器引擎如何为目标组装和反汇编处理器指令。
这些选项由具有以下位标志的位集表示。
不断 | 描述 |
---|---|
DEBUG_ASMOPT_VERBOSE |
设置此位后,反汇编中将包含其他信息。
这等效于 .asm 命令中的 详细 选项。 |
DEBUG_ASMOPT_NO_CODE_BYTES |
设置此位后,指令的原始字节不会包含在反汇编中。
这等效于 .asm 命令中的 no_code_bytes 选项。 |
DEBUG_ASMOPT_IGNORE_OUTPUT_WIDTH |
设置此位后,调试器在反汇编期间设置指令时忽略输出显示的宽度。
这相当于 .asm 命令中的 ignore_output_width 选项。 |
DEBUG_ASMOPT_SOURCE_LINE_NUMBER |
设置此位后,反汇编输出的每一行都以符号信息提供的源代码行号为前缀。
这等效于 .asm 命令中的 source_line 选项。 |
此外,值DEBUG_ASMOPT_DEFAULT表示程序集和反汇编选项的默认集。 这意味着上表中的所有选项都处于关闭状态。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |