次の方法で共有


IDebugControl2::Output メソッド (dbgeng.h)

Output メソッドは文字列の書式を設定し、エンジンのクライアントに登録されている出力コールバックに結果を送信します。

構文

HRESULT Output(
  [in] ULONG Mask,
  [in] PCSTR Format,
       ...   
);

パラメーター

[in] Mask

出力型のビット フィールドを指定します。 使用可能な値については 、「DEBUG_OUTPUT_XXX 」を参照してください。

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

...

書式設定中に出力に挿入する値を含む追加のパラメーターを指定します。

戻り値

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

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

注釈

非常に大きな出力文字列を生成する場合、デバッガー エンジンまたはオペレーティング システムの制限に達する可能性があります。 たとえば、デバッガー エンジンの一部のバージョンでは、1 つの出力に対して 16,000 文字の制限があります。 非常に大きな出力が切り捨てられている場合は、出力を複数の要求に分割する必要がある場合があります。

要件

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

こちらもご覧ください

。Printf

ControlledOutput

IDebugControl

IDebugControl2

IDebugControl3

OutputVaList

dprintf