IDebugControl3::OutputPrompt 方法 (dbgeng.h)
OutputPrompt 方法格式化并将用户提示发送到输出回调对象。
语法
HRESULT OutputPrompt(
[in] ULONG OutputControl,
[in, optional] PCSTR Format,
...
);
参数
[in] OutputControl
指定一个输出控件,该控件确定哪个客户端的输出回调将接收输出。 有关可能的值,请参阅 DEBUG_OUTCTL_XXX。
[in, optional] Format
指定格式字符串,如 在 printf 中所示。 通常,转换字符的工作方式与在 C 中完全相同。对于浮点转换字符,64 位参数被解释为 32 位浮点数,除非使用 l 修饰符。
支持 %p 转换字符,但它表示目标地址空间中的指针。 它可能没有任何修饰符,并且使用调试器的内部地址格式。 支持以下附加转换字符。
字符 | 参数类型 | 参数 | 打印的文本 |
---|---|---|---|
%p | ULONG64 | 地址空间中的指针。 | 指针的值。 |
%N | DWORD_PTR (32 或 64 位,具体取决于主机的体系结构) | 主机虚拟地址空间中的指针。 | 指针的值。 (这等效于标准 C %p 字符。) |
%I | ULONG64 | 任何 64 位值。 | 指定的值。 如果此值大于 0xFFFFFFFF,则将其打印为 64 位值;否则,它将打印为 32 位值。 |
%ma | ULONG64 | 进程虚拟地址空间中以 NULL 结尾的 ASCII 字符串的地址。 | 指定的字符串。 |
%mu | ULONG64 | 进程的虚拟地址空间中以 NULL 结尾的 Unicode 字符串的地址。 | 指定的字符串。 |
%msa | ULONG64 | 进程的虚拟地址空间中ANSI_STRING结构的地址。 | 指定的字符串。 |
%msu | ULONG64 | 进程的虚拟地址空间中UNICODE_STRING结构的地址。 | 指定的字符串。 |
%y | ULONG64 | 包含符号信息的项的进程虚拟地址空间中的地址。 | 包含指定符号的名称的字符串 (和置换(如果有任何) )。 |
%ly | ULONG64 | 包含符号信息的项的进程虚拟地址空间中的地址。 | 包含指定符号的名称的字符串 (和置换(如果有任何) )以及任何可用的源行信息。 |
如果 Format 为 NULL,则仅将标准提示文本发送到输出回调。
...
指定其他参数,这些参数表示在格式设置期间要插入到输出中的值。
返回值
返回代码 | 说明 |
---|---|
|
方法成功。 |
此方法还可以返回错误值。 有关更多详细信息 ,请参阅返回值 。
注解
OutputPrompt 和 OutputPromptWide 可用于提示用户输入。
标准提示将先发送到输出回调,然后再使用 Format 描述的格式化文本。 标准提示的内容由 GetPromptText 方法返回。
提示文本将发送到设置了 DEBUG_OUTPUT_PROMPT 输出掩码的输出回调。
有关提示用户的详细信息,请参阅 使用输入和输出。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |