IDebugControl::OutputPromptVaList メソッド (dbgeng.h)

[アーティクル]
02/06/2025

OutputPromptVaList メソッドは、出力コールバックオブジェクトにユーザープロンプトを送信します。

構文

HRESULT OutputPromptVaList(
  [in]           ULONG   OutputControl,
  [in, optional] PCSTR   Format,
  [in]           va_list Args
);

パラメーター

[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 場合、標準のプロンプトテキストのみが出力コールバックに送信されます。

[in] Args

書式設定中に出力に挿入される値を表す追加のパラメーターを指定します。引数は、va_startを使用して初期化する必要があります。このメソッドは va_endを呼び出しません。

戻り値

このメソッドは、エラー値を返すこともできます。詳細については戻り値のを参照してください。

リターンコード	形容
S_OK	メソッドが成功しました。

備考

OutputPromptVaList と OutputPromptVaListWide を使用して、ユーザーに入力を求めることができます。

標準プロンプトは、Formatで記述された書式設定されたテキストの前に出力コールバックに送信されます。標準プロンプトの内容は、GetPromptText メソッドによって返されます。

プロンプトテキストは、DEBUG_OUTPUT_PROMPT 出力マスクが設定された出力コールバックに送信されます。

ユーザーにプロンプトを表示する方法の詳細については、「入力と出力を使用する」を参照してください。

必要条件

要件	価値
ターゲットプラットフォームの	デスクトップ
ヘッダー	dbgeng.h (Dbgeng.h、Stdarg.h を含む)

次の方法で共有

IDebugControl::OutputPromptVaList メソッド (dbgeng.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース