Format eines Textprotokollabschnitts

Ein Textprotokollabschnitt enthält einen Abschnittsheader, der den Abschnitt öffnet, einen Abschnittstext, der eine Sequenz von Protokolleinträgen enthält, die für den Abschnittsvorgang gelten, und eine Abschnittsfußzeile, die den Abschnitt schließt. Abschnittseinträge werden in einem Abschnitt in derselben Reihenfolge angezeigt, in der sie in den Abschnitt geschrieben werden.

Das folgende Beispiel eines Textprotokollabschnitts zeigt das allgemeine Format eines typischen Abschnitts, bei dem die Felder im kursiven Schriftstil Platzhalter für abschnittsspezifischen Text sind, und der verbleibende Text in fett formatierter Schriftart ist generischer Text, der von SetupAPI bereitgestellt wird. Die ersten beiden Protokolleinträge umfassen den Abschnittsheader und die letzten beiden Protokolleinträge die Abschnittsfußzeile.

>>>  [section_title - instance_identifier]
>>> time_stamp Section start
 section body log entry
 section body log entry
 section body log entry
<<<  [time_stamp: Section end]
<<<  [Exit Status(status_value)]

Die protokollierten Abschnittstexteinträge hängen von der Ereignisebene ab, die für das Protokoll festgelegt ist, und den Kategorieebenen, die für das Protokoll aktiviert sind. Weitere Informationen zu diesen Einstellungen finden Sie unter SetupAPI-Protokollierungsregistrierungseinstellungen.

Im Folgenden finden Sie ein typisches Beispiel für einen Textprotokollabschnitt, den der Plug & Play-Manager (PnP) erstellt hat, um Einträge zu protokollieren, die sich auf die Installation eines PCI-Geräts beziehen. Im Abschnittsheader lautet das section_title Feld "Device Install", das instance_identifier Feld ist der Geräte-instance Bezeichner "PCI\VEN_104C&DEV_8019&SUBSYS_8010104C&REV_00\3&61aaa01&0&38" und das time_stamp Feld "2005/02/13 22:06:28.109:" In der Abschnittsfußzeile lautet das status_value Feld "0x00000000" und das time_stamp Feld "2005/02/13 22:06:20.000:" In diesem Beispiel sind nur die ersten drei Textkörperprotokolleinträge des Abschnitts enthalten. Die Ereignisebene für dieses Beispiel wurde auf TXTLOG_DETAILS festgelegt, und für dieses Beispiel wurden alle Kategorieebenen aktiviert.

>>>  [Device Install - PCI\VEN_104C&DEV_8019&SUBSYS_8010104C&REV_00\3&61aaa01&0&38]
>>>  2005/02/13 22:06:20.000: Section start
     ndv: Retrieving device info...
     ndv: Setting device parameters...
     ndv: Building driver list...
...  
...  additional section body log entries, which are not shown
...  
<<<  [2005/02/13 22:06:28.109: Section end]
<<<  [Exit Status(0x00000000)]

Ausführliche Informationen zum Inhalt und Format eines Textprotokollabschnitts finden Sie unter Format of a Text Log Section Header, Format of a Text Log Section Body, and Format of a Text Log Section Footer.