テキスト ログ セクション本文の書式

テキストログ セクションの本文 には、テキストログ セクションに関連付けられている操作に適用される0件以上のログエントリが含まれています。 セクション本文ログエントリの形式には 、次のように、entry_prefix フィールド、time_stamp フィールド、event_category フィールド、インデント フィールド、および formatted_message フィールドが含まれます。

entry_prefix time_stamp event_category インデント formatted_message
セクション本文のログエントリの最大(文字数は336文字です。

entry_prefix フィールド
ログエントリがエラーメッセージ、警告メッセージ、または情報メッセージのいずれであるかを示します。 entry_prefix フィールドは常に存在し、次の表に示す文字列のいずれかを含みます。

Entry_prefix フィールド	メッセージの種類
"!!!    "	エラーメッセージ
"!      "	警告メッセージ
" "	エラーメッセージまたは警告メッセージ以外の情報メッセージ

time_stamp フィールド
ログ記録されたイベントの発生時刻を示しています。 time_stamp フィールドは任意であり、タイムスタンプはSetupAPI にデフォルトでは含まれません。 ただし、SetupWriteTextLog はログエントリにタイムスタンプを含めることに対応しています。 time_stamp フィールドの形式は、テキスト ログ セクション ヘッダーの形式 で説明されている time_stamp フィールドの形式と同じです。

event_category フィールド
ログエントリを作成した SetupAPI 操作のカテゴリを示します。 event_category フィールドは通常存在しますが、必須ではありません。 event_category フィールドが存在する場合は、次の表に示す文字列のいずれかが含まれます。

Event_category フィールド文字列	SetupAPI 操作
"...: "	ベンダーが提供する操作
"bak: "	バックアップ データ
"cci: "	クラスインストーラーまたは共同インストーラー操作
"cpy: "	ファイルのコピー
"dvi: "	デバイスのインストール
"flq: "	ファイルキューの管理
"inf: "	INF ファイルを管理する
"ndv: "	新規デバイスウィザード
"prp: "	デバイス プロパティを表示および管理する
"reg: "	レジストリ設定の管理
"set: "	全般設定
"sig: "	デジタル署名を検証する
"sto: "	ドライバーストアを管理
"ui : "	ユーザー インターフェイス ダイアログボックスを管理
"ump: "	ユーザーモード PnP マネージャー

インデント フィールド
0 個以上のインデント単位のシーケンスで構成され、インデント単位とは、5つのスペースを含む単一スペース文字列です。 インデント フィールドは任意であり、SetupAPI にはデフォルトではインデントは含まれません。 SetupWriteTextLog では、ログエントリに含まれるインデント 単位の数の変更に対応しています。

formatted_message フィールド
ログエントリに適用される特定の情報を格納します。

ログに記録されるセクション本文のエントリは、ログに設定されているイベントレベルと、ログに対して有効化されているカテゴリレベルによって異なります。 これらの設定の詳細については、SetupAPIログ記録レジストリ設定 を参照してください。

SetupAPIは、デバイスのインストールに適用される操作をグループ化するセクションを作成するときに、サブセクションのセクション本文ログエントリも再帰的にグループ化します。 SetupAPIは、ログエントリに注釈を付けてインデントする方法によってサブセクションを区別します。 このようなサブセクションの1つが、一般的なデバイスのインストールセクションからの次の抜粋に示されています。 サブセクションはログエントリ「dvi: {Build Driver List}」で始まり、ログエントリ「dvi: {Build Driver List - exit(0x00000000)}」で終わります。 このサブセクションでは、entry_prefix、event_category、インデント、および formatted_message フィールドを含むログエントリの一般的なシーケンスを示します。 ログエントリを書き込んだ SetupAPI 操作もインデントを作成し、書式付きのメッセージの内容を提供しました。 この例のイベントレベルは TXTLOG_DETAILS に設定され、この例ではすべてのカテゴリレベルが有効になりました。

>>>  [Device Install - PCI\VEN_104C&DEV_8019&SUBSYS_8010104C&REV_00\3&61aaa01&0&38]
>>>  2005/02/13 22:06:28.109: Section start
...
 Additional section body log entries
...
     dvi: {Build Driver List}
     dvi:      Enumerating all INFs...
     dvi:      Found driver match:
     dvi:           HardwareID - PCI\VEN_104C&DEV_8019
     dvi:           InfName    - C:\WINDOWS\inf\1394.inf
     dvi:           DevDesc    - Texas Instruments OHCI Compliant IEEE 1394 Host Controller
     dvi:           DrvDesc    - Texas Instruments OHCI Compliant IEEE 1394 Host Controller
     dvi:           Provider   - Microsoft
     dvi:           Mfg        - Texas Instruments
     dvi:           InstallSec - TIOHCI_Install
     dvi:           ActualSec  - TIOHCI_Install.NT
     dvi:           Rank       - 0x00002001
     dvi:           DrvDate    - 10/01/2002
     dvi:           Version    - 6.0.5033.0 
!!!  inf:      InfCache: Error flagging 1394.inf for match string pci\ven_104c&dev_8019
     dvi: {Build Driver List - exit(0x00000000)}
...
 Additional section body log entries 
...
<<<  [2005/02/13 22:06:29.000: Section end]
<<<  [Exit Status(0x00000000)]