Format d’un corps de section de journal de texte

Le corps d’une section de journal de texte contient zéro ou plusieurs entrées de journal qui s’appliquent à l’opération associée à une section de journal de texte. Le format d’une entrée de journal du corps de section comprend un champ entry_prefix , un champ time_stamp , un champ de event_category , un champ de retrait et un champ formatted_message , comme suit :

entry_prefix time_stamp event_category formatted_message de retrait
La longueur maximale, en caractères, d’une entrée de journal du corps de section est de 336.

champ entry_prefix
Indique si l’entrée de journal est un message d’erreur, un message d’avertissement ou un message d’information. Le champ entry_prefix est toujours présent et contient l’une des chaînes répertoriées dans le tableau suivant :

champ time_stamp
Indique l’heure système à laquelle l’événement journalisé s’est produit. Le champ time_stamp est facultatif et SetupAPI n’inclut pas d’horodatage par défaut. Toutefois, SetupWriteTextLog prend en charge l’inclusion d’un horodatage dans une entrée de journal. Le format du champ time_stamp est identique au format du champ time_stamp décrit dans Format d’un en-tête de section du journal de texte.

champ event_category
Indique la catégorie de l’opération SetupAPI qui a effectué l’entrée du journal. Le champ event_category est généralement présent, mais n’est pas obligatoire. Si le champ event_category est présent, il contient l’une des chaînes répertoriées dans le tableau suivant :

Champ de mise en retrait
Se compose d’une séquence de zéro ou plusieurs unités de retrait, où une unité de mise en retrait est une chaîne monospace qui contient cinq espaces. Le champ retrait est facultatif et SetupAPI n’inclut pas la mise en retrait par défaut. SetupWriteTextLog prend en charge la modification du nombre d’unités de retrait incluses dans une entrée de journal.

champ formatted_message
Contient les informations spécifiques qui s’appliquent à l’entrée de journal.

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.

Lorsque SetupAPI crée une section qui regroupe les opérations qui s’appliquent à une installation d’appareil, il regroupe également de manière récursive les entrées du journal du corps de section dans les sous-sections. SetupAPI distingue les sous-sections par la façon dont il annote et met en retrait les entrées de journal. Une sous-section de ce type apparaît dans l’extrait suivant d’une section d’installation d’appareil classique. La sous-section commence par l’entrée de journal « dvi : {Build Driver List} » et se termine par l’entrée de journal « dvi: {Build Driver List - exit(0x00000000)} ». Cette sous-section présente une séquence classique d’entrées de journal qui incluent les champs entry_prefix, event_category, retrait et formatted_message . Les opérations SetupAPI qui ont écrit les entrées de journal ont également créé la mise en retrait et fourni le contenu des messages mis en forme. 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: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)]