Chamar SetupWriteTextLogInfLine

Um aplicativo pode chamar SetupWriteTextLogInfLine para gravar uma entrada de log em um log de texto SetupAPI que contém o texto de uma linha de arquivo INF especificada.

Para chamar SetupWriteTextLogInfLine, um aplicativo fornece as seguintes informações:

• O token de log de uma seção em um log de texto que foi obtido chamando SetupGetThreadLogToken ou um dos tokens de log definidos pelo sistema. Se o token de log estiver associado a uma seção de log de texto, SetupWriteTextLogInfLine gravará a entrada de log nessa seção. Caso contrário, SetupWriteTextLogInfLine adicionará a entrada de log a uma parte do log que não está incluída em uma seção de log de texto.

  Além disso, se SetupWriteTextLogInfLine grava uma entrada de log e em qual log de texto SetupWriteTextLogInfLine grava a entrada, depende do valor do token de log definido pelo sistema.

  Para obter mais informações sobre tokens de log, consulte Configurando e obtendo um token de log para um thread.

• Um valor de sinalizador que é um OR bit a bit de constantes definidas pelo sistema que especificam o nível do evento, a profundidade de recuo e se deve incluir um carimbo de data/hora. Os níveis de evento são descritos em Definindo o nível de evento para um log de texto.

  Se o nível de evento definido para o log de texto for maior ou igual ao nível de evento da entrada, SetupWriteTextLogInfLine gravará uma entrada de log no log de texto. Caso contrário, SetupWriteTextLogInfLine não gravará uma entrada de log no log de texto. Usando recuo, as mensagens formatadas podem ser organizadas para tornar as informações em uma seção mais fáceis de ler e entender.

  Para obter mais informações, consulte Gravando entradas de log recuadas.

• Um identificador para o arquivo INF que contém a linha de arquivo INF.

• O contexto da linha de arquivo INF.

SetupWriteTextLogInfLine grava uma entrada de log no seguinte formato:

entry_prefix time_stamp inf:indentation inf-line-text (inf-file-name line line-number)

Onde:

• Os campos entry_prefix, carimbo de data/hora e recuo são os mesmos descritos em Formato de um corpo de seção de log de texto.

• O campo inf: especifica a categoria de evento TXTLOG_INF. As categorias de eventos são descritas em Habilitando categorias de eventos para um log de texto.

• O campo inf-line-text contém o texto da linha de arquivo INF especificada.

• O campo inf-file-name contém o nome do arquivo INF que contém a linha de arquivo INF especificada.

• O campo de linha indica que o que se segue é um número de linha no arquivo INF.

• O campo de número de linha contém o número de linha da linha especificada no arquivo INF.

O exemplo a seguir mostra como um aplicativo normalmente registra o texto de uma linha INF em um log de texto. A linha INF neste exemplo é uma linha INF AddReg . O aplicativo chama SetupWriteTextLogInfLine, fornecendo os seguintes valores de parâmetro de entrada:

• LogToken é definido como um token de log que foi retornado por SetupGetThreadLogToken ou para um token de log definido pelo sistema.

• LogFlags está definido como TXTLOG_DETAILS. Este exemplo não inclui um carimbo de data/hora nem altera a profundidade do recuo. No exemplo, a profundidade de recuo é de cinco espaços de texto monoespaçados.

• InfHandle é definido como um identificador para o arquivo INF hidserv.inf. Esse identificador é obtido chamando a função SetupOpenInfFile , que está documentada no SDK da plataforma.

• O contexto é definido como o contexto do arquivo INF da linha de arquivo INF que contém o texto "AddReg=HidServ_AddService_AddReg". Um contexto de arquivo INF para a linha é obtido chamando as funções SetupFindXxxLine , que estão documentadas no SDK da Plataforma.

Os valores de LogToken e LogFlags afetam a operação de SetupWriteTextLogInfLine da mesma maneira que a descrita para SetupWriteTextLog. Além disso, SetupWriteTextLogInfLine usa o catálogo de eventos TXTLOG_INF.

Para este exemplo, o seguinte mostra o tipo de entrada de log que SetupWriteTextLogInfLine gravaria em um log de texto:

   inf:      AddReg=HidServ_AddService_AddReg  (hidserv.inf line 98)