IDebugControl2::OutputPrompt 方法 (dbgeng.h)

OutputPrompt 方法格式化并向输出回调对象发送用户提示。

语法

HRESULT OutputPrompt(
  [in]           ULONG OutputControl,
  [in, optional] PCSTR Format,
                 ...   
);

参数

[in] OutputControl

指定一个输出控件,用于确定客户端的输出回调将接收输出。 有关可能的值,请参阅 DEBUG_OUTCTL_XXX

[in, optional] Format

指定格式字符串,如 printf 中所示。 通常,转换字符的工作方式与 C 中完全相同。对于浮点转换字符,除非使用 l 修饰符,否则 64 位参数将解释为 32 位浮点数。

支持 %p 转换字符,但它表示目标地址空间中的指针。 它可能没有任何修饰符,并且它使用调试器的内部地址格式。 支持以下附加转换字符。

字符 参数类型 参数 打印的文本
%p ULONG64 地址空间中的指针。 指针的值。
%N DWORD_PTR (32 或 64 位,具体取决于主机的体系结构) 主机虚拟地址空间中的指针。 指针的值。 (这相当于标准 C %p character.)
%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 包含符号信息的项的进程的虚拟地址空间中的地址。 包含指定符号的名称的字符串 (和偏移量(如果有) ),以及任何可用的源行信息。
 

如果 FormatNULL,则仅将标准提示文本发送到输出回调。

...

指定表示在格式设置过程中要插入到输出中的值的其他参数。

返回值

返回代码 说明
S_OK
该方法成功。
 

此方法还可以返回错误值。 有关更多详细信息,请参阅 返回值

注解

OutputPromptOutputPromptWide 可用于提示用户输入。

标准提示将发送到输出回调,然后才能使用 Format 描述的格式文本。 标准提示的内容由 方法 GetPromptText 返回。

提示文本将发送到输出回调,并设置了 DEBUG_OUTPUT_PROMPT 输出掩码。

有关提示用户的详细信息,请参阅 使用输入和输出

要求

   
目标平台 桌面
Header dbgeng.h (包括 Dbgeng.h)

另请参阅

ControlledOutput

DEBUG_OUTPUT_XXX

GetPromptText

IDebugControl

IDebugControl2

IDebugControl3

OutputPromptVaList