Format d’une section de journal de texte

Une section de journal de texte comprend un en-tête de section qui ouvre la section, un corps de section qui inclut une séquence d’entrées de journal qui s’appliquent à l’opération de section et un pied de page de section qui ferme la section. Les entrées de section apparaissent dans une section dans l’ordre dans lequel elles sont écrites dans la section.

L’exemple suivant d’une section de journal de texte montre le format général d’une section classique, où les champs dans le style de police italique sont des espaces réservés pour le texte spécifique à la section, et le texte restant en style de police gras est du texte générique fourni par SetupAPI. Les deux premières entrées de journal comprennent l’en-tête de section et les deux dernières entrées de journal constituent le pied de page de section.

>>>  [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)]

Les entrées de corps de section journalisées dépendent du niveau d’événement défini pour le journal et des niveaux de catégorie activés pour le journal. Pour plus d’informations sur ces paramètres, consultez ConfigurationParamètres du Registre de journalisation API.

Voici un exemple typique d’une section de journal texte que le gestionnaire de Plug-and-Play (PnP) a créée pour journaliser les entrées relatives à l’installation d’un appareil PCI. Dans l’en-tête de section, le champ section_title est « Installation de l’appareil », le champ instance_identifier est l’identificateur de instance de l’appareil « PCI\VEN_104C&DEV_8019&SUBSYS_8010104C&REV_00\3&61aaa01&0&38 » et le champ time_stamp est « 2005/02/13 22 :06 :28.109 : ». Dans le pied de page de section, le champ status_value est « 0x00000000 » et le champ time_stamp est « 2005/02/13 22 :06 :20.000 : ». Seules les trois premières entrées du journal du corps de section sont incluses dans cet exemple. Le niveau d’événement de cet exemple a été défini sur TXTLOG_DETAILS et tous les niveaux de catégorie ont été activés pour cet exemple.

>>>  [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)]

Pour plus d’informations sur le contenu et le format d’une section de journal de texte, consultez Format d’un en-tête de section de journal de texte, Format d’un corps de section de journal de texte et Format d’un pied de page de section de journal de texte.