IDebugControl3::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 文字と同じです)。 |
%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 出力マスクが設定された出力コールバックに送信されます。
ユーザーにプロンプトを表示する方法の詳細については、「 入力と出力の使用」を参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | dbgeng.h (Dbgeng.h を含む) |