Formato de una sección de registro de texto

Una sección de registro de texto incluye un encabezado de sección que abre la sección, un cuerpo de sección que incluye una secuencia de entradas de registro que se aplican a la operación de sección y un pie de página de sección que cierra la sección. Las entradas de sección aparecen en una sección en el mismo orden en que se escriben en la sección.

En el ejemplo siguiente de una sección de registro de texto se muestra el formato general de una sección típica, donde los campos del estilo de fuente cursiva son marcadores de posición para texto específico de sección y el texto restante en negrita es texto genérico proporcionado por SetupAPI. Las dos primeras entradas de registro componen el encabezado de sección y las dos últimas entradas de registro componen el pie de página de sección.

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

Las entradas del cuerpo de la sección que se registran dependen del nivel de evento establecido para el registro y los niveles de categoría habilitados para el registro. Para obtener más información sobre esta configuración, consulte Configuración del Registro de LA API.

A continuación se muestra un ejemplo típico de una sección de registro de texto que el administrador de Plug and Play (PnP) creó para registrar las entradas que pertenecían a la instalación de un dispositivo PCI. En el encabezado de sección, el campo section_title es "Device Install", el campo instance_identifier es el identificador de instancia de dispositivo "PCI\VEN_104C&DEV_8019&SUBSYS_8010104C&REV_00\3&61aaa01&0&38" y el campo time_stamp es "2005/02/13 22:06:28.109:". En el pie de página de sección, el campo status_value es "0x00000000" y el campo time_stamp es "2005/02/13 22:06:20.000:". En este ejemplo solo se incluyen las tres primeras entradas del registro del cuerpo de la sección. El nivel de evento de este ejemplo se estableció en TXTLOG_DETAILS y todos los niveles de categoría se habilitaron para este ejemplo.

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

Para obtener información detallada sobre el contenido y el formato de una sección de registro de texto, vea Formato de un encabezado de sección de registro de texto, Formato de un cuerpo de sección de registro de texto y Formato de un pie de página de sección de registro de texto.