WPP 拡張書式指定文字列とは

  • [アーティクル]

WPP には、 printf 用 に定義されている標準書式指定文字列に加えて、トレース メッセージで使用できる定義済みの書式指定文字列が含まれています。

%!FLAGS!、 %!FUNC!、 %!LEVEL! 文字列は トレース メッセージ プレフィックス内の文字列や DoTraceMessageなどの任意のトレース関数またはマクロ内の文字列で使用できます。

他の拡張文字列は、任意のトレース関数で使用できます。

tracewpp の既定の構成オプション

WPP では、既定の構成設定に "defaultwpp.ini" が使用されます。 この既定の INI ファイルは、WppConfig Rev1 ディレクトリの Windows SDK の一部として含まれています。 WPP の既定の動作に関する最新情報と、カスタマイズに関する追加情報については、この INI ファイルを参照してください。

ソフトウェア トレース

[書式設定文字列] 説明
%!FILE! トレース メッセージの生成元のソース ファイルの名前を表示します。 この変数は、 トレース メッセージ プレフィックスでも使用できます。
%!FLAGS! トレース メッセージを有効にする トレース フラグ の値を表示します。 この変数は、 トレース メッセージ プレフィックスでも使用できます。
%!FUNC! トレース メッセージを生成した関数を表示します。 この変数は、 トレース メッセージ プレフィックスでも使用できます。
%!LEVEL! トレース メッセージを有効にする トレース レベル の名前を表示します。 この変数は、 トレース メッセージ プレフィックスでも使用できます。
%!LINE! トレース プレフィックスを生成したコード内の行番号を表示します。 この変数は、 トレース メッセージ プレフィックスでも使用できます。

一般的な使用

[書式設定文字列] 説明
%!bool! TRUE または FALSE を表示します
%!irql! 現在の IRQL 名を表示します。
%!sid! セキュリティ識別子 (pSID) へのポインターを表します。 SID を表示します。
GUID
%!GUID! GUID (pGUID)へのポインターを表します。 ポイントされている GUID を表示します。
%!CLSID! クラス ID。 クラス ID GUID のポインターを表します。 GUID に関連付けられている文字列を表示します。 WPP は、トレース メッセージの書式を設定するときに、レジストリ内の文字列を検索します。
%!LIBID! タイプ ライブラリ。 COM タイプ ライブラリの GUID を表します。 GUID に関連付けられている文字列を表示します。 WPP は、トレース メッセージの書式を設定するときに、レジストリ内の文字列を検索します。
%!IID! インターフェイス ID。 インターフェイス ID GUID へのポインターを表します。 GUID に関連付けられている文字列を表示します。 WPP は、トレース メッセージの書式を設定するときに、レジストリ内の文字列を検索します。
Time
%!delta! 2 つの時間値の差をミリ秒単位で表示します。 これは LONGLONG 値で、 day~h:m:s 形式で表示されます。
%!WAITTIME! 何かが完了するのを待機するために費やされた時間をミリ秒単位で表示します。 これは LONGLONG 値で、 day~h:m:s 形式で表示されます。 %!due! と共に使用するように設計されています。
%!due! 何かが完了すると予想される時間をミリ秒単位で表示します。 これは LONGLONG 値で、 day~h:m:s 形式で表示されます。 %!WAITTIME! と使用するためにデザイン済み。
%!TIMESTAMP!
%!datetime!
%!TIME!		 特定の時点のシステム時刻の値を表示します。 これらは、SYSTEMTIME 形式で表示される LONGLONG (SINT64) 値です。
これらの変数を使用して、プログラム内のさまざまな時間値を表し、それらを区別することができます。

リターン コード

[書式設定文字列] 説明
%!STATUS! 状態値を表し、状態コードに関連付けられている文字列を表示します。
%!WINERROR! Windows エラー コードを表し、エラーに関連付けられている文字列を表示します。
%!HRESULT! エラーまたは警告を表し、HRESULT 形式でコードを表示します。

ネットワーク

[書式設定文字列] 説明
%!IPADDR! IP アドレスへのポインターを表します。 IP アドレスを表示します。
%!PORT! ポート番号を表示します。