IDebugControl3::SetAssemblyOptions 方法 (dbgeng.h)
SetAssemblyOptions 方法设置程序集和反汇编选项,这些选项会影响调试器引擎如何为目标组装和反汇编处理器指令。
语法
HRESULT SetAssemblyOptions(
[in] ULONG Options
);
参数
[in] Options
指定 调试器引擎要使用的新程序集和反汇编选项。 选项 是位集;它将替换现有的程序集和反汇编选项。 有关可能的值,请参阅备注。 DEBUG_ASMOPT_DEFAULT可用于设置默认选项。
返回值
此方法还可以返回错误值。 有关更多详细信息 ,请参阅返回值 。
返回代码 | 说明 |
---|---|
|
方法成功。 |
注解
有关将程序集与调试器引擎 API 配合使用的详细信息,请参阅 汇编和反汇编说明。
程序集和反汇编选项会影响调试器引擎如何为目标组装和反汇编处理器指令。
选项由具有以下位标志的位集表示。
一直 | 说明 |
---|---|
DEBUG_ASMOPT_VERBOSE |
设置此位后,反汇编中包含其他信息。
这等效于 .asm 命令中的 verbose 选项。 |
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) |