Registros de texto de SetupAPI

In Windows Vista and later versions of Windows, SetupAPI supports a device installation text log (SetupAPI.dev.log) and an application installation text log (SetupAPI.app.log). El administrador de Plug and Play (PnP) y SetupAPI escriben entradas en el registro de texto de instalación del dispositivo para proporcionar información sobre las operaciones que instalan dispositivos y controladores. El administrador de PnP y SetupAPI escriben entradas en el registro de texto de instalación de la aplicación que proporcionan información sobre las operaciones de instalación distintas de las que pertenecen específicamente a las instalaciones de dispositivos y controladores.

Las aplicaciones de instalación, los instaladores de clase y los coinstaladores pueden usar las funciones de registro setupAPI para escribir entradas en el registro de instalación del dispositivo y en el registro de texto de instalación de la aplicación.

The SetupAPI text logs are ANSI plain text files, which are located by default in the %SystemRoot%\inf directory. Los registros de texto están en el idioma inglés (estándar).

Los registros de texto setupAPI tienen el siguiente formato interno:

• A log entry is one line in a text log.

• Las primeras entradas de registro proporcionan un encabezado de registro de texto que contiene información sobre el sistema operativo y la arquitectura del equipo. Para obtener más información, vea Formato de un encabezado de registro de texto.

• Después del encabezado de registro de texto hay cero o más secciones de registro de texto. Cada sección de registro de texto registra los eventos durante una sola instalación de dispositivo.

  El propósito de una sección de registro de texto es agrupar y dar formato a una secuencia contigua de entradas de registro que proporcionan información sobre una operación de instalación determinada. Al crear secciones de registro de texto, el administrador de PnP, SetupAPI o una aplicación de instalación personalizada puede organizar entradas de registro de una manera conceptualmente significativa. Por ejemplo, el administrador de PnP podría crear una sección de registro de texto para agrupar todas las entradas de registro que se aplican a la instalación de un dispositivo. Las secciones de registro de texto aparecen en un registro de texto en el orden en que se crean. Para obtener más información, vea Formato de una sección de registro de texto.

• Un registro de texto puede contener entradas de registro que no forman parte del encabezado de registro de texto o una sección de registro de texto. Estas entradas están asociadas a operaciones que no forman parte de ninguna sección de registro de texto determinada y, en general, se intercalan entre secciones de registro de texto. Las entradas de registro que no forman parte de una sección de registro de texto aparecen en el registro en el mismo orden en el que se escriben en el registro de texto. Para obtener más información sobre estas entradas de registro, vea Formato de entradas de registro que no forman parte de una sección de registro de texto.