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

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 シンボル情報を含む項目のプロセスの仮想アドレス空間内のアドレス。 指定した記号の名前 (および変位がある場合)、および使用可能なソース行情報を含む文字列。
 

FormatNULL の場合、標準のプロンプト テキストのみが出力コールバックに送信されます。

[in] Args

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

戻り値

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

リターン コード 説明
S_OK
メソッドは正常に実行されました。

注釈

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

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

プロンプト テキストは、DEBUG_OUTPUT_PROMPT出力マスク セットを使用して出力コールバック 送信されます。

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

要件

要件
対象プラットフォーム デスクトップ
Header dbgeng.h (Dbgeng.h、Stdarg.h を含む)

こちらもご覧ください

ControlledOutputVaList

DEBUG_OUTPUT_XXX

GetPromptText

IDebugControl

IDebugControl2

IDebugControl3

OutputPrompt