Formato di una sezione Log di testo

Una sezione del log di testo include un'intestazione di sezione che apre la sezione, un corpo della sezione che include una sequenza di voci di log che si applicano all'operazione di sezione e un piè di pagina della sezione che chiude la sezione. Le voci di sezione vengono visualizzate in una sezione nello stesso ordine in cui vengono scritti nella sezione.

L'esempio seguente di una sezione del log di testo mostra il formato generale di una sezione tipica, in cui i campi in stile carattere corsivo sono segnaposto per il testo specifico della sezione e il testo rimanente in stile grassetto è testo generico fornito da SetupAPI. Le prime due voci di log comprendono l'intestazione della sezione e le ultime due voci di log comprendono il piè di pagina della sezione.

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

Le voci del corpo della sezione registrate dipendono dal livello di evento impostato per il log e i livelli di categoria abilitati per il log. Per altre informazioni su queste impostazioni, vedere Impostazioni del Registro di sistema di registrazione setupAPI.

Di seguito è riportato un esempio tipico di una sezione del log di testo creata dal gestore Plug and Play (PnP) per registrare le voci relative all'installazione di un dispositivo PCI. Nell'intestazione della sezione il campo section_title è "Installazione dispositivo", il campo instance_identifier è l'identificatore dell'istanza del dispositivo "PCI\VEN_104C&DEV_8019&SUBSYS_8010104C&REV_00\3&61a01&0&38" e il campo time_stamp è "2005/02/13 22:06:28.109:". Nel piè di pagina della sezione il campo status_value è " 0x00000000 " e il campo time_stamp è "2005/02/13 22:06:20.000:". In questo esempio sono incluse solo le prime tre voci del log del corpo della sezione. Il livello di evento per questo esempio è stato impostato su TXTLOG_DETAILS e tutti i livelli di categoria sono stati abilitati per questo esempio.

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

Per informazioni dettagliate sul contenuto e il formato di una sezione log di testo, vedere Formato di un'intestazione di sezione log di testo, formato di un corpo della sezione log di testo e formato di un piè di pagina della sezione log di testo.