Visão geral do manifesto de log

O manifesto de log é o grupo de arquivos de "cabeçalho" que definem as funções e interfaces COM que são interceptadas e registradas. Esses não são arquivos de cabeçalho C++ verdadeiros. Eles estão em um formato ligeiramente diferente que declara explicitamente as informações necessárias para o Logger.

Por exemplo, o formato de manifesto facilita os seguintes recursos:

• Designação de parâmetros OUT. São parâmetros que devem ser registrados tanto no caminho para uma função quanto na saída.

• Definição de máscaras de sinalização. Esse recurso permite que o LogViewer quebre um sinalizador DWORD nos rótulos de bits constituintes para facilitar a leitura.

• Definição de casos de falha. Esse recurso permite que o LogViewer sombreie as linhas de funções que retornaram um código de status de falha ou outro código de erro. Além disso, se a função definir o valor "LastError" para o thread, o LogViewer poderá armazenar o código de erro e expandi-lo para a mensagem de erro legível por humanos correspondente.

• Designação de parâmetros que podem ter alias para diferenciação de log. Esse recurso dá ao LogViewer a opção de atribuir uma string constante a um valor que muda de execução para execução, como ponteiros e identificadores quando exporta os dados para um arquivo. Em seguida, você pode usar uma ferramenta de diferenciação para comparar dois logs de execução para discrepâncias. Se os ponteiros e os valores de identificador não tivessem alias, eles produziriam discrepâncias desinteressantes quando os dois arquivos fossem comparados.