Journaux textuels de l'interface 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). Le gestionnaire Plug-and-Play (PnP) et les entrées d’écriture SetupAPI dans le journal texte d’installation de l’appareil pour fournir des informations sur les opérations qui installent des appareils et des pilotes. Le gestionnaire PnP et setupAPI écrivent des entrées dans le journal de texte d’installation de l’application qui fournissent des informations sur les opérations d’installation autres que celles qui se rapportent spécifiquement aux installations de périphérique et de pilote.

Les applications d’installation, les programmes d’installation de classes et les co-programmes d’installation peuvent utiliser les fonctions de journalisation SetupAPI pour écrire des entrées dans le journal d’installation de l’appareil et le journal de texte d’installation de l’application.

The SetupAPI text logs are ANSI plain text files, which are located by default in the %SystemRoot%\inf directory. Les journaux de texte sont dans la langue anglaise (Standard).

Les journaux de texte SetupAPI ont le format interne suivant :

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

• Les premières entrées de journal fournissent un en-tête de journal de texte qui contient des informations sur le système d’exploitation et l’architecture de l’ordinateur. Pour plus d’informations, consultez Format d’un en-tête de journal de texte.

• Après l’en-tête du journal de texte, vous ne trouverez pas de sections de journal de texte ou plus. Chaque section du journal texte enregistre les événements lors d’une installation unique de l’appareil.

  L’objectif d’une section de journal de texte est de regrouper et de mettre en forme une séquence contiguë d’entrées de journal qui fournissent des informations sur une opération d’installation particulière. En créant des sections de journal de texte, le gestionnaire PnP, SetupAPI ou une application d’installation personnalisée peuvent organiser les entrées de journal de manière conceptuellement significative. Par exemple, le gestionnaire PnP peut créer une section de journal de texte pour regrouper toutes les entrées de journal qui s’appliquent à l’installation d’un appareil. Les sections du journal de texte apparaissent dans un journal de texte dans l’ordre dans lequel elles sont créées. Pour plus d’informations, consultez Format d’une section du journal de texte.

• Un journal de texte peut contenir des entrées de journal qui ne font pas partie de l’en-tête du journal de texte ou d’une section de journal de texte. Ces entrées sont associées à des opérations qui ne font pas partie d’une section de journal de texte particulière et, en général, sont entrelacées entre les sections du journal de texte. Les entrées de journal qui ne font pas partie d’une section de journal de texte apparaissent dans le journal dans le même ordre dans lequel elles sont écrites dans le journal de texte. Pour plus d’informations sur ces entrées de journal, consultez Format des entrées de journal qui ne font pas partie d’une section de journal de texte.