(dbgeng.h) IDebugControl3::OutputPrompt 方法
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 字元。) |
%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) |